# directive-synthesis

directive-synthesis is a Claude Code skill for building slash commands, from arguments and frontmatter to Bash steps and testing.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 127 installs · ★ 50 repo stars
- Author: qodex-ai
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/directive-synthesis/SKILL.md
- Updated: 2026-01-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/directive-synthesis

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill directive-synthesis -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/directive-synthesis/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/directive-synthesis/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill directive-synthesis -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/directive-synthesis/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill directive-synthesis -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/directive-synthesis/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install qodex-ai/ai-agent-skills skills/directive-synthesis
```

2. **Manually: put the files in place**
- File: `.github/skills/directive-synthesis/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill directive-synthesis -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/directive-synthesis
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/directive-synthesis/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill directive-synthesis -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/directive-synthesis/SKILL.md

## When to use it
- 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
- Create a Claude Code slash command that reviews the file passed as `$1` and define its frontmatter.
- Build a command that reads `git status` and `git diff`, with the required Bash permissions.
- Check this command name, place the command in the project directory, and prepare a test invocation.

## Similar
- [812-regulations-eu-product-liability-directive](https://affpapa.org/en/nevibecode/skills/812-regulations-eu-product-liability-directive.md) — skill · 165 installs
- [nis2-directive-specialist](https://affpapa.org/en/nevibecode/skills/nis2-directive-specialist.md) — skill · 105 installs
- [knowledge-synthesis](https://affpapa.org/en/nevibecode/skills/knowledge-synthesis.md) — skill · 6600 installs
- [research-synthesis](https://affpapa.org/en/nevibecode/skills/research-synthesis.md) — skill · 4400 installs
- [voicebox-voice-synthesis](https://affpapa.org/en/nevibecode/skills/voicebox-voice-synthesis.md) — skill · 1400 installs
- [discover-interview-synthesis](https://affpapa.org/en/nevibecode/skills/discover-interview-synthesis.md) — skill · 866 installs

From the same set: [qodex-ai/ai-agent-skills](https://affpapa.org/en/nevibecode/by/qodex-ai/ai-agent-skills.md) — 42 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
