Skip to content

docs: add Agent Skill setup option for Claude Code#135

Open
w0yne wants to merge 1 commit intoawslabs:mainfrom
w0yne:claude-code-skill
Open

docs: add Agent Skill setup option for Claude Code#135
w0yne wants to merge 1 commit intoawslabs:mainfrom
w0yne:claude-code-skill

Conversation

@w0yne
Copy link

@w0yne w0yne commented Mar 20, 2026

Summary

Add Option 3: Agent Skill under the Claude Code section of README, showing how to package AI-DLC as an Agent Skill.

What Changed

README.md only — no new files, no content duplication.

The new option shows how to assemble a skill directory from the existing aidlc-rules/ content:

  • Creates SKILL.md with YAML frontmatter + core-workflow.md content (path refs updated via sed)
  • Copies aws-aidlc-rule-details/ as references/

Why

  • Enables /aidlc slash command in Claude Code
  • Follows the open Agent Skills standard — also works with Cursor, Gemini CLI, OpenCode, etc.
  • No repo structure changes needed — just a documentation addition alongside the existing Option 1/Option 2

Pre-built Skill

A ready-to-use pre-built version of this skill is available at w0yne/aidlc-claude-code-skill, which contains the assembled aidlc/ directory (SKILL.md + references/) that can be directly copied to ~/.claude/skills/ or .claude/skills/.

Testing

Verified the skill works correctly with Claude Code in an empty project:

  • /aidlc slash command triggers the full AI-DLC workflow
  • Workspace Detection → Requirements Analysis stages execute as expected
  • aidlc-state.md, audit.md, and structured question files are generated correctly
  • Security Extension opt-in from references/extensions/ is recognized

@w0yne w0yne requested a review from a team as a code owner March 20, 2026 04:17
@w0yne w0yne force-pushed the claude-code-skill branch from 50a2a72 to 28663bb Compare March 20, 2026 04:21
@w0yne w0yne changed the title feat: add Claude Code Agent Skill packaging docs: add Agent Skill setup option for Claude Code Mar 20, 2026
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.
@w0yne w0yne force-pushed the claude-code-skill branch from 28663bb to 6ee95d4 Compare March 20, 2026 04:25
@scottschreckengaust
Copy link
Member

What types of results can you share?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants