How do I install the Vibeknow Core skill?

Run npx skillmds@latest add vibeknow/vibeknow-core in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Vibeknow Core safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Vibeknow Core?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Vibeknow Core free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Vibeknow Core?

vibeknow (@vibeknow) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Vibeknow Core by vibeknow — Agent Skill

Name: Vibeknow Core
Author: vibeknow

File contents

vibeknow-core

TRIGGER

First-time vibeknow setup or onboarding
Authentication errors or credential issues
Switching between environments (dev/staging/prod)
Diagnosing connection or endpoint problems
Managing profiles or config values

SKIP

Video generation, status, download → use vibeknow-create
Document upload or status → use vibeknow-doc

Core Concepts

Profile: A named environment config (endpoints + credential). Supports dev/staging/prod switching via vibeknow profile use <name>.
Credential priority: VIBEKNOW_TOKEN env var > OS keychain > encrypted file. The env var overrides everything and cannot be cleared by logout.
Endpoint trust boundary: Profiles pointing to localhost or non-official domains must set --trust dev --is-production=false, or the CLI refuses to start.
Doctor: Runs endpoint reachability checks and token validation. Use it first when anything seems wrong.

Quick Reference

Command	Description
`vibeknow auth status`	Show credential source and active profile
`vibeknow auth whoami`	Print current authenticated user
`vibeknow auth logout`	Clear stored credential for current profile
`vibeknow profile add NAME`	Add a new profile
`vibeknow profile use NAME`	Switch active profile
`vibeknow profile list`	List all profiles
`vibeknow profile show [NAME]`	Show profile details (default: current)
`vibeknow profile remove NAME`	Delete a profile
`vibeknow config get KEY`	Read a config value
`vibeknow config set KEY VALUE`	Write a config value
`vibeknow config list`	List all config keys
`vibeknow doctor`	Diagnose local setup and endpoint reachability

For full flags and output examples, see commands.md.

Common Tasks

Check if vibeknow is working

vibeknow doctor
vibeknow auth status

Set up a new dev environment

vibeknow profile add dev \
  --endpoint-figlens http://localhost:20067 \
  --trust dev \
  --is-production=false \
  --credential-ref vibeknow.dev
vibeknow profile use dev
vibeknow doctor

Switch between environments

vibeknow profile list              # see available profiles
vibeknow profile use prod          # switch to prod
vibeknow auth status               # verify credentials

Diagnose auth failure

vibeknow auth status               # check credential source
vibeknow auth whoami               # verify identity
vibeknow doctor                    # check endpoint reachability

Exit Code Handling

Exit	Meaning	Action
0	Success	—
1	General error	Check stderr message
2	Invalid arguments	Fix command syntax
3	Auth error	Run `vibeknow auth status`, check credential source
130	User interrupt (SIGINT)	—

For full exit code and error code reference, see errors.md.

Output Formats

All core commands support --output text|json|ndjson:

vibeknow auth status --output json    # structured output
vibeknow profile list --output json   # machine-readable profile list

References

commands.md — Full flag reference for all 12 subcommands
errors.md — Exit codes, error codes, and Error Object schema

---name: vibeknow-coredescription: vibeknow CLI setup, authentication, profile management, and diagnostics. Use when: first-time setup, auth errors, switching environments, diagnosing connection issues.---# vibeknow-core## TRIGGER- First-time vibeknow setup or onboarding- Authentication errors or credential issues- Switching between environments (dev/staging/prod)- Diagnosing connection or endpoint problems- Managing profiles or config values## SKIP- Video generation, status, download → use **vibeknow-create**- Document upload or status → use **vibeknow-doc**## Core Concepts- **Profile**: A named environment config (endpoints + credential). Supports dev/staging/prod switching via `vibeknow profile use <name>`.- **Credential priority**: `VIBEKNOW_TOKEN` env var > OS keychain > encrypted file. The env var overrides everything and cannot be cleared by `logout`.- **Endpoint trust boundary**: Profiles pointing to localhost or non-official domains must set `--trust dev --is-production=false`, or the CLI refuses to start.- **Doctor**: Runs endpoint reachability checks and token validation. Use it first when anything seems wrong.## Quick Reference| Command | Description ||---------|-------------|| `vibeknow auth status` | Show credential source and active profile || `vibeknow auth whoami` | Print current authenticated user || `vibeknow auth logout` | Clear stored credential for current profile || `vibeknow profile add NAME` | Add a new profile || `vibeknow profile use NAME` | Switch active profile || `vibeknow profile list` | List all profiles || `vibeknow profile show [NAME]` | Show profile details (default: current) || `vibeknow profile remove NAME` | Delete a profile || `vibeknow config get KEY` | Read a config value || `vibeknow config set KEY VALUE` | Write a config value || `vibeknow config list` | List all config keys || `vibeknow doctor` | Diagnose local setup and endpoint reachability |For full flags and output examples, see [commands.md](references/commands.md).## Common Tasks### Check if vibeknow is working```bashvibeknow doctorvibeknow auth status```### Set up a new dev environment```bashvibeknow profile add dev \ --endpoint-figlens http://localhost:20067 \ --trust dev \ --is-production=false \ --credential-ref vibeknow.devvibeknow profile use devvibeknow doctor```### Switch between environments```bashvibeknow profile list # see available profilesvibeknow profile use prod # switch to prodvibeknow auth status # verify credentials```### Diagnose auth failure```bashvibeknow auth status # check credential sourcevibeknow auth whoami # verify identityvibeknow doctor # check endpoint reachability```## Exit Code Handling| Exit | Meaning | Action ||------|---------|--------|| 0 | Success | — || 1 | General error | Check stderr message || 2 | Invalid arguments | Fix command syntax || 3 | Auth error | Run `vibeknow auth status`, check credential source || 130 | User interrupt (SIGINT) | — |For full exit code and error code reference, see [errors.md](references/errors.md).## Output FormatsAll core commands support `--output text|json|ndjson`:```bashvibeknow auth status --output json # structured outputvibeknow profile list --output json # machine-readable profile list```## References- [commands.md](references/commands.md) — Full flag reference for all 12 subcommands- [errors.md](references/errors.md) — Exit codes, error codes, and Error Object schema

Frequently asked questions

Vibeknow Core