Skip to main content
skills install writes the difyctl skill (a SKILL.md file) into the skill directories of the coding agents on your machine. The skill deliberately lists no commands: it points the agent at difyctl help -o json and lets it discover the live command surface itself. See the help reference for that discovery surface, and Install the difyctl Skill for the full integration.

​
Install the Skill

difyctl skills install [dir] [flags]
This command is fully local: it needs no sign-in and never contacts a server.

​
Arguments

  • dir: optional. Install into this single directory, bypassing agent detection. The skill lands at <dir>/SKILL.md. Cannot be combined with --agent.

​
Flags

FlagTypeDefaultDescription
-y, --yesbooleanfalseWrite the skill. Without it, the command is a dry run: it lists where the skill would land and writes nothing.
--agentstring, repeatablenoneRestrict the install to specific detected agents, by name. Repeat the flag or pass a comma-separated list. Naming an agent that isn’t detected is a usage error.
--stdoutbooleanfalsePrint the skill to stdout and write nothing. Cannot be combined with --yes, --agent, or dir.

​
Examples

Preview where the skill would be installed (dry run, the default): 
difyctl skills install
Install into every detected agent: 
difyctl skills install --yes
Install into one agent only: 
difyctl skills install --yes --agent claude-code
Install into an explicit directory, for an agent the CLI doesn’t detect: 
difyctl skills install ./my-skills/difyctl --yes
Print the skill without writing anything: 
difyctl skills install --stdout

​
Agent Detection

Detection checks whether each agent’s configuration directory exists. The CLI never probes PATH or launches anything. The skill is written to each agent’s documented user-level skill location:
AgentDetected whenSkill lands in
claude-code~/.claude exists~/.claude/skills/difyctl/SKILL.md
codex~/.codex exists~/.agents/skills/difyctl/SKILL.md
opencode~/.config/opencode exists~/.config/opencode/skills/difyctl/SKILL.md
cursor~/.cursor exists~/.cursor/skills/difyctl/SKILL.md
pi~/.pi exists~/.pi/agent/skills/difyctl/SKILL.md
An agent that’s installed but has never been launched may not have its configuration directory yet. Install into its skill directory explicitly with difyctl skills install <dir>.

​
Output

A dry run lists the detected agents and the target paths, then tells you how to proceed: 
Detected 2 agents: claude-code, cursor

would write to claude-code: /Users/you/.claude/skills/difyctl/SKILL.md
would write to cursor: /Users/you/.cursor/skills/difyctl/SKILL.md

Re-run with --yes to write all, or --agent <name> to write only some.
Agent not listed? Install into its directory with `difyctl skills install <dir>`.
With --yes, each write is confirmed: 
wrote /Users/you/.claude/skills/difyctl/SKILL.md
wrote /Users/you/.cursor/skills/difyctl/SKILL.md
When nothing is detected, the command explains the alternatives and exits 0: 
No agents detected (looked for ~/.claude, ~/.codex, ~/.config/opencode, ~/.cursor, ~/.pi).
Install into a directory manually with `difyctl skills install <dir>`, or
print the skill with `difyctl skills install --stdout`.
The installed skill carries a version stamp matching the CLI that wrote it. Re-running skills install --yes after upgrading replaces the file with the current version. Re-running is always safe.

​
Exit Codes

CodeMeaning
0Success, including a dry run and the nothing-detected case
1Local failure, such as a target directory that isn’t writable
2Usage error: --stdout combined with a write option, dir combined with --agent, or --agent naming an agent that isn’t detected
Last modified on June 25, 2026