Skip to content
EN
Get API key
Browse documentation

Get started

Manage your FlashData skills

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.

Install and verify · Codex
flashdata setup --agent codex --directory . --skip-auth --non-interactive --json
flashdata skills verify --agent codex --directory . --json

Where 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.

HostProjectUser-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.

List the bundled skills and revision
flashdata skills list --json

Install 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.

Google Search only · this project
flashdata setup --agent codex --directory . --skill google-search --skip-auth --non-interactive --json
flashdata skills verify --agent codex --directory . --skill google-search --json

3. 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.

No paid query
flashdata --version
flashdata doctor --offline
flashdata auth status --json

Update 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

SymptomAction
Missing skill filesCheck --agent, --directory / --global and --skill. Verify the same location and selection you installed.
Hash mismatch / local changeReview the reported file against the bundled revision. Preserve your changes before replacing anything, then rerun installation and verification.
Symlink or installation lockUse 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 itOpen the intended project, check the host's skill location and restart its session.
Verified but API calls failCheck 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.

Continue using FlashData