Skip to content

Commit 6ee95d4

Browse files
Stev WayneStev Wayne
authored andcommitted
docs: add Agent Skill setup option for Claude Code
Add Option 3 under Claude Code section showing how to package AI-DLC as an Agent Skill (https://agentskills.io). Assembles SKILL.md from existing core-workflow.md with YAML frontmatter and copies rule details as references. No file duplication — uses the same aidlc-rules/ content. Enables /aidlc slash command in Claude Code and is compatible with other Agent Skills-compliant tools.
1 parent 94cdfe8 commit 6ee95d4

File tree

1 file changed

+51
-0
lines changed

1 file changed

+51
-0
lines changed

README.md

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -381,6 +381,57 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule-
381381
└── operations/
382382
```
383383

384+
#### Option 3: Agent Skill
385+
386+
Package AI-DLC as an [Agent Skill](https://agentskills.io) for Claude Code. This enables the `/aidlc` slash command and automatic activation on development tasks. Also compatible with other Agent Skills-compliant tools (Cursor, Gemini CLI, OpenCode, etc.).
387+
388+
**Unix/Linux/macOS:**
389+
```bash
390+
# Create the skill directory
391+
mkdir -p ~/.claude/skills/aidlc/references
392+
393+
# Create SKILL.md with frontmatter + core workflow
394+
cat > ~/.claude/skills/aidlc/SKILL.md << 'EOF'
395+
---
396+
name: aidlc
397+
description: >-
398+
AI-DLC (AI-Driven Development Life Cycle) adaptive workflow for software
399+
development. Use when building new features, creating applications,
400+
refactoring systems, or any software development task that benefits from
401+
structured planning, requirements analysis, and phased execution with
402+
quality gates.
403+
---
404+
405+
EOF
406+
# Append core workflow (replace path references for skill layout)
407+
sed \
408+
's|Check these paths in order and use the first one that exists:|The rule detail files are in the `references/` directory relative to this skill:|
409+
/^\- `\.aidlc-rule-details/d
410+
/^\- `\.kiro/d
411+
/^\- `\.amazonq/d
412+
s|All subsequent rule detail file references.*resolved above\.|All rule detail file references (e.g., `common/process-overview.md`, `inception/workspace-detection.md`) are relative to the `references/` directory.|
413+
s|`extensions/`|`references/extensions/`|g
414+
s|under `extensions/|under `references/extensions/|g' \
415+
~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md >> ~/.claude/skills/aidlc/SKILL.md
416+
417+
# Copy rule details as references
418+
cp -R ~/Downloads/aidlc-rules/aws-aidlc-rule-details/* ~/.claude/skills/aidlc/references/
419+
```
420+
421+
**Directory Structure:**
422+
```
423+
~/.claude/skills/aidlc/
424+
├── SKILL.md
425+
└── references/
426+
├── common/
427+
├── inception/
428+
├── construction/
429+
├── operations/
430+
└── extensions/
431+
```
432+
433+
> **Note:** Use `~/.claude/skills/` for personal skills (available across all projects) or `.claude/skills/` for project-level skills.
434+
384435
---
385436

386437
### GitHub Copilot

0 commit comments

Comments
 (0)