flypod install skill
Write flypod usage instructions into your repo's agent config files so coding agents (Claude Code, Codex, Cursor, and more) know how to deploy with flypod.
flypod install skill teaches the coding agents working in a repo how to deploy
with flypod. It writes a small, self-contained instruction file into each
agent's config format, so the next time you ask an agent to "deploy this," it
knows to run flypod.
flypod install skillBy default it writes two files: the universal AGENTS.md (read by Codex,
Cursor, Copilot, Gemini, Zed, and ~20 other tools) and a first-class Claude
Code skill. Any other supported agent that it detects in the repo is added on
top.
Run it from your project root. The command is non-interactive by default (safe for agents and CI); when a human runs it in a terminal with no target flags, an arrow-key picker appears to choose targets.
Synopsis
flypod install skill [targets] [flags]Targets
Each target is one agent's instruction-file convention. AGENTS.md and Claude
are always written; the rest are written when detected (or when you pass their
flag).
| Target | Flag | File written | Default |
|---|---|---|---|
| AGENTS.md (universal) | --agents | AGENTS.md | Always |
| Claude Code | --claude | .claude/skills/flypod/SKILL.md | Always |
| Cursor | --cursor | .cursor/rules/flypod.mdc | If detected |
| GitHub Copilot | --copilot | .github/copilot-instructions.md | If detected |
| Windsurf | --windsurf | .windsurf/rules/flypod.md | If detected |
| Cline | --cline | .clinerules/flypod.md | If detected |
| Roo Code | --roo | .roo/rules/flypod.md | If detected |
| Gemini CLI | --gemini | GEMINI.md | If detected |
Passing one or more target flags writes exactly those targets (overriding the defaults).
Flags
| Flag | Description |
|---|---|
--all | Write every supported target, detected or not. |
--global | Write to your home directory instead of the project (for AGENTS.md, Claude, and Gemini, which have standard global locations). |
--list | Print which targets are detected and where each would be written; write nothing. |
--dry-run | Show the files that would be written, then exit without touching disk. (--print is an alias.) |
Examples
Install the defaults (AGENTS.md + Claude, plus anything detected):
flypod install skillSee what's detected without writing anything:
flypod install skill --listWrite only the Cursor and Claude files:
flypod install skill --cursor --claudeInstall into every supported agent:
flypod install skill --allIdempotency
The command is safe to re-run. Shared files like AGENTS.md get a delimited
flypod block that is replaced in place on each run, leaving the rest of the
file untouched. Dedicated files (the Claude skill, Cursor rules) are
flypod-owned and rewritten wholesale. A target that's already up to date is
reported as unchanged.