Skip to content

Commit c3aadab

Browse files
janhestersclaude
janhesters
and
claude
committed
feat(skills): add agentskills.io compatible workflow skills
Add unified skills/ directory following the agentskills.io specification for multi-agent support (Claude Code, Cursor, Antigravity, etc.). Skills included: - aidd-discover: Product discovery, user journeys, personas - aidd-task: Epic/task planning with requirements - aidd-execute: TDD implementation workflow - aidd-review: Code review with OWASP security checks - aidd-log: Activity logging for completed work - aidd-commit: Conventional commit formatting - aidd-user-test: Human and AI test script generation Each skill follows the SKILL.md format with: - aiddCommands frontmatter for command extraction - Full SudoLang type definitions and functions - Commands blocks for all workflow commands - Cross-references to other rules and skills Added command extraction infrastructure: - lib/skills-extractor.js: Parse skills and generate command files - Pre-commit hook: Auto-generate ai/commands/*.md and skills/index.md - ai/commands/help.md: References skills/index.md for command discovery Updated AGENTS.md with setup instructions for: - Claude Code (copy AGENTS.md to CLAUDE.md, symlink skills) - Cursor (symlink skills to .cursor/skills) This approach allows a single skills/ directory to work with all compatible agents via symlinks, maintaining user control over .cursor and .claude directories. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 4425f40 commit c3aadab

File tree

35 files changed

+1974
-141
lines changed

35 files changed

+1974
-141
lines changed

‎.gitignore‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -140,6 +140,7 @@ vite.config.ts.timestamp-*
140140

141141
# AI agent tools
142142
.agent-tools/
143+
.claude/
143144

144145
# Core dump files
145146
core

‎.husky/pre-commit‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,10 @@
1+
# Extract commands from skills/ and generate command files
2+
node bin/aidd.js --skills "$(git rev-parse --show-toplevel)"
3+
4+
# Stage generated skills and command files
5+
git add 'skills/index.md' 2>/dev/null || true
6+
git add 'ai/commands/*.md' 2>/dev/null || true
7+
18
# Generate index.md files for ai/ folders
29
node bin/aidd.js --index "$(git rev-parse --show-toplevel)"
310

‎AGENTS.md‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,3 +41,54 @@ If any conflicts are detected between a requested task and the vision document,
4141
3. Ask the user to clarify how to resolve the conflict before proceeding
4242

4343
Never proceed with a task that contradicts the vision without explicit user approval.
44+
45+
## Agent Skills
46+
47+
AIDD includes reusable skills in the `skills/` directory following the [agentskills.io](https://agentskills.io) specification. These skills work with any compatible agent (Claude Code, Cursor, etc.).
48+
49+
### Available Skills
50+
51+
| Skill | Purpose |
52+
|-------|---------|
53+
| `aidd-discover` | Product discovery, user journeys, personas |
54+
| `aidd-task` | Plan and break down epics into tasks |
55+
| `aidd-execute` | Implement using TDD |
56+
| `aidd-review` | Code review with security focus |
57+
| `aidd-log` | Document changes to activity-log.md |
58+
| `aidd-commit` | Conventional commit formatting |
59+
| `aidd-user-test` | Generate human and AI test scripts |
60+
61+
### Setup for Claude Code
62+
63+
Claude Code doesn't natively support `AGENTS.md`. To enable AIDD:
64+
65+
```bash
66+
# Copy or symlink AGENTS.md to CLAUDE.md
67+
cp AGENTS.md CLAUDE.md
68+
# or: ln -s AGENTS.md CLAUDE.md
69+
70+
# Symlink skills directory
71+
mkdir -p .claude
72+
ln -s ../skills .claude/skills
73+
```
74+
75+
### Setup for Cursor
76+
77+
```bash
78+
# Symlink skills directory (Cursor also discovers .claude/skills)
79+
mkdir -p .cursor
80+
ln -s ../skills .cursor/skills
81+
```
82+
83+
### Manual Invocation
84+
85+
Primary commands invoke their corresponding skill:
86+
- `/task` - Plan a new epic
87+
- `/execute` - Implement with TDD
88+
- `/review` - Code review
89+
- `/discover` - Product discovery
90+
- `/commit` - Conventional commits
91+
- `/log` - Activity logging
92+
- `/user-test` - Generate test scripts
93+
94+
For the complete command reference including sub-commands, see `skills/index.md`.

‎ai/commands/commit.md‎

Lines changed: 3 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,5 @@
1-
# Commit
1+
# /commit
22

3-
Act as a senior software engineer to commit changes to the repository in non-interactive modes ONLY, using the following template:
3+
create a conventional commit for staged changes
44

5-
"$type${[(scope)]}{[!]}: $description":where `[]` is optional and `!` is a breaking change
6-
7-
Types: fix|feat|chore|docs|refactor|test|perf|build|ci|style|revert|$other
8-
9-
Constraints {
10-
When committing, don't log about logging in the commit message.
11-
Use multiple -m flags, one for each log entry.
12-
Limit the first commit message line length to 50 characters.
13-
Use conventional commits with the supplied template.
14-
Do NOT add new things to the CHANGELOG.md file.
15-
}
5+
Use the commit skill to create a conventional commit for staged changes.

‎ai/commands/discover.md‎

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,5 @@
1-
## 🔍 Discover
1+
# /discover
22

3-
Use productmanager.mdc to discover a user journey, user story, or feature.
3+
Enter interactive product discovery planning mode
44

5-
Constraints {
6-
Begin by reading the file and asking the user relevant questions to spark the discovery process.
7-
Before beginning, read and respect the constraints in please.mdc.
8-
}
5+
Use the discover skill to enter interactive product discovery planning mode.

‎ai/commands/execute.md‎

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,5 @@
1-
## ⚙️ Execute Task/Epic
1+
# /execute
22

3-
Use the task creator to execute a task epic.
3+
implement code using TDD (red-green-refactor cycle)
44

5-
Constraints {
6-
Before beginning, read and respect the constraints in please.mdc.
7-
Remember to use the TDD process if asked to implement code.
8-
}
5+
Use the execute skill to implement code using tdd (red-green-refactor cycle).

‎ai/commands/help.md‎

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
1-
## ❓ Help
1+
# /help
22

3-
List commands from please.mdc and report them to the user.
3+
List available commands and their usage.
4+
5+
Read [skills/index.md](../../skills/index.md) for complete command reference and build help text from it.
46

57
Constraints {
6-
Before beginning, read and respect the constraints in please.mdc.
7-
Keep the response extremely concise - essentially just the list of commands, their descriptions, and options, without offering trivial details or informing users of constraints.
8+
Before beginning, read and respect the constraints in @ai/rules/please.mdc.
9+
Keep the response extremely concise - essentially just the list of commands, their descriptions, and options, without offering trivial details or informing users of constraints.
810
}

‎ai/commands/index.md‎

Lines changed: 25 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -1,66 +1,50 @@
1-
# commands
1+
# AIDD Commands
22

3-
This index provides an overview of the contents in this directory.
3+
Primary workflow entry points. Each command activates its corresponding skill.
44

5-
## Files
5+
For complete command reference including sub-commands, see [skills/index.md](../../skills/index.md).
66

7-
### Commit
7+
## Commands
88

9-
**File:** `commit.md`
9+
### /commit
1010

11-
*No description available*
11+
create a conventional commit for staged changes
1212

13-
### discover
13+
**Skill:** [aidd-commit](../../skills/aidd-commit/SKILL.md)
1414

15-
**File:** `discover.md`
15+
### /discover
1616

17-
*No description available*
17+
Enter interactive product discovery planning mode
1818

19-
### execute
19+
**Skill:** [aidd-discover](../../skills/aidd-discover/SKILL.md)
2020

21-
**File:** `execute.md`
21+
### /execute
2222

23-
*No description available*
23+
implement code using TDD (red-green-refactor cycle)
2424

25-
### help
25+
**Skill:** [aidd-execute](../../skills/aidd-execute/SKILL.md)
2626

27-
**File:** `help.md`
27+
### /log
2828

29-
*No description available*
29+
log completed epics to activity-log.md
3030

31-
### log
31+
**Skill:** [aidd-log](../../skills/aidd-log/SKILL.md)
3232

33-
**File:** `log.md`
33+
### /review
3434

35-
*No description available*
35+
conduct a thorough code review focusing on code quality, best practices, and adherence to project standards
3636

37-
### plan
37+
**Skill:** [aidd-review](../../skills/aidd-review/SKILL.md)
3838

39-
**File:** `plan.md`
39+
### /task
4040

41-
*No description available*
41+
create a task/epic
4242

43-
### 🔬 Code Review
43+
**Skill:** [aidd-task](../../skills/aidd-task/SKILL.md)
4444

45-
**File:** `review.md`
45+
### /user-test
4646

47-
*No description available*
47+
Generate human and agent scripts, save to $projectRoot/plan/
4848

49-
### run-test
50-
51-
**File:** `run-test.md`
52-
53-
*No description available*
54-
55-
### task
56-
57-
**File:** `task.md`
58-
59-
*No description available*
60-
61-
### user-test
62-
63-
**File:** `user-test.md`
64-
65-
*No description available*
49+
**Skill:** [aidd-user-test](../../skills/aidd-user-test/SKILL.md)
6650

‎ai/commands/log.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
1-
## 📝 Log
1+
# /log
22

3-
Use log.mdc to collect salient changes, and log them to the activity-log.md.
4-
Before beginning, read and respect the constraints in please.mdc.
3+
log completed epics to activity-log.md
4+
5+
Use the log skill to log completed epics to activity-log.md.

‎ai/commands/review.md‎

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,5 @@
1-
# 🔬 Code Review
1+
# /review
22

3-
use review.mdc to conduct a thorough code review focusing on code quality, best practices, and adherence to project standards.
3+
conduct a thorough code review focusing on code quality, best practices, and adherence to project standards
44

5-
Constraints {
6-
Before beginning, read and respect the constraints in please.mdc.
7-
}
5+
Use the review skill to conduct a thorough code review focusing on code quality, best practices, and adherence to project standards.

0 commit comments

Comments
 (0)