directive-synthesis — Claude Code skill: commands and install
directive-synthesis is a Claude Code skill for building slash commands, from arguments and frontmatter to Bash steps and testing.
LicenseRef-Proprietary 127 installs ★ 50 updated 2026-01-05
npx skills add qodex-ai/ai-agent-skills --skill directive-synthesis -a claude-codeWhat directive-synthesis does
directive-synthesis guides the design of custom Claude Code slash commands. It helps collect the command requirements, validate the name and parameters, choose a simple prompt or frontmatter-based file, and lay out the execution flow. The documented patterns include $ARGUMENTS, positional values such as $1, file references with @, and Bash substitutions using !.
The skill also covers personal and project command locations, namespace folders, and a basic testing path through /help and a sample invocation. Bash steps require explicit allowed-tools permissions; that setting is part of the command definition rather than an optional detail.
The package lists support for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Its examples use command arguments, file checks, Git context, and test commands to shape a repeatable workflow.
What it helps with
- create a slash command with parameters
- define a command workflow step by step
- add Bash checks before prompt execution
- choose a personal or project command path
- test a command through
/help
Example prompts for the agent
- Create a Claude Code slash command that reviews the file passed as
$1and define its frontmatter. - Build a command that reads
git statusandgit diff, with the required Bash permissions. - Check this command name, place the command in the project directory, and prepare a test invocation.
How to install directive-synthesis
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill directive-synthesis -a claude-code2Manually: put the files in place
~/.claude/skills/directive-synthesis/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/directive-synthesis/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill directive-synthesis -a codex2Manually: put the files in place
.agents/skills/directive-synthesis/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill directive-synthesis -a cursor2Manually: put the files in place
.cursor/skills/directive-synthesis/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install qodex-ai/ai-agent-skills skills/directive-synthesis2Manually: put the files in place
.github/skills/directive-synthesis/SKILL.md1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill directive-synthesis -a gemini-cli2Platform CLI
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/directive-synthesisManually: put the files in place
.devin/skills/directive-synthesis/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill directive-synthesis -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about directive-synthesis
How do I install directive-synthesis in Claude Code?
Run npx skills add qodex-ai/ai-agent-skills --skill directive-synthesis -a claude-code. The skill file will then be available at ~/.claude/skills/directive-synthesis/SKILL.md.
What does directive-synthesis do?
It helps design Claude Code slash commands with arguments, frontmatter, Bash permissions, file references, and ordered workflow steps.
How does directive-synthesis handle Bash execution?
It places command output into the prompt context before Claude Code processes the rest of the instruction. Each Bash pattern needs matching allowed-tools permissions.