Browse documentation
Get started
Choose an installation location, verify the bundle and update or remove skills.
On this page
1. Install in the right location
Use an installed FlashData CLI. Choose one location below and run both commands. --skip-auth installs the bundled skills offline without creating a trial or changing credentials.
Replace codex with claude-code or cursor for those hosts. Use --directory PATH for another project; it cannot be combined with --global. Codex and Cursor share a project installation.
flashdata setup --agent codex --directory . --skip-auth --non-interactive --json
flashdata skills verify --agent codex --directory . --jsonflashdata setup --agent codex --global --skip-auth --non-interactive --json
flashdata skills verify --agent codex --global --jsonWhere the files go
Other hosts use the independent installer or whole-directory copies from the official repository. Keep SKILL.md and its supporting files together.
| Host | Project | User-wide |
|---|---|---|
| Codex | .agents/skills | ~/.agents/skills |
| Claude Code | .claude/skills | ~/.claude/skills or $CLAUDE_CONFIG_DIR/skills |
| Cursor | .agents/skills | ~/.cursor/skills |
2. Read the verification result
skills verify compares the selected installation with the current executable's bundled revision. Expect ok: true and data.verified: true; data.directories identifies the checked location and data.sourceCommit identifies the bundled source revision. This confirms files, not API access.
skills list lists what this CLI can install, not what is installed in your agent.
flashdata skills list --jsonInstall only a selected skill
Use the same --skill, --agent and location flags for installation and verification. Omitting --skill checks the default bundle, which will report missing files when you installed only a subset.
flashdata setup --agent codex --directory . --skill google-search --skip-auth --non-interactive --json
flashdata skills verify --agent codex --directory . --skill google-search --json3. Reload the agent and check access
Start a fresh agent session so it loads the installed skills. Run the checks inside that session with the OS user, profile and state directory used for login. FLASHDATA_API_KEY overrides the saved key. For a custom profile, add its --profile and --state-dir to auth status.
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonUpdate without losing local changes
Upgrade the CLI using your original installer, then rerun the matching install-and-verify pair from step 1. Keep the same host, location and --skill selection. Unmodified managed files update; conflicting or locally modified files cause the command to stop for review. Reload the agent after verification passes.
For a repository installation, update the whole skill directory, including references, scripts and assets. The CLI's bundled revision can differ from the repository's latest commit.
Fix a failed check
| Symptom | Action |
|---|---|
| Missing skill files | Check --agent, --directory / --global and --skill. Verify the same location and selection you installed. |
| Hash mismatch / local change | Review the reported file against the bundled revision. Preserve your changes before replacing anything, then rerun installation and verification. |
| Symlink or installation lock | Use a normal directory. Check whether another installer is running before handling a stale lock; do not remove an active lock. |
| Verified but the agent cannot find it | Open the intended project, check the host's skill location and restart its session. |
| Verified but API calls fail | Check auth status in the agent environment. Skill files do not supply credentials or credits. |
Remove skills or revoke access
Disable the skills in your host or remove their installed directories to stop loading instructions. Revoke agent access separately in Connected apps, or revoke an imported key in API Keys. Removing skills does not revoke credentials.