feat: agentskills build output#277
Conversation
Add build/skills/ directory containing AI-DLC rules converted to AgentSkills format for use with compatible agents.
Add Build Output section describing the build/skills/ directory and its purpose as generated artifacts from source AI-DLC rules.
harmjeff
left a comment
There was a problem hiding this comment.
Thanks for the contribution! The idea of making AI-DLC available in AgentSkills format is great, but we need to fix the approach before merging.
Issue: Checked-in build output creates copy-paste maintenance problems.
Committing 30 generated files directly to the repo means every time the source rules change, someone has to manually regenerate and update these files — or they drift out of sync. This doesn't scale.
What we need instead:
A build tool/script (e.g., scripts/build-agentskills.sh or a CI workflow) that generates the AgentSkills output from the source rules at release time. This way:
- Source rules remain the single source of truth
- The build output is always in sync with the latest release
- No manual copy-paste maintenance burden
- Contributors only edit source rules, not generated artifacts
The build/ directory should be in .gitignore, and the generation should happen as part of the release pipeline (or on-demand via a script users can run locally).
Please rework this PR to include the conversion tool/script rather than the static output files. Happy to discuss the approach if helpful.
Summary
Add AI-DLC rules converted to AgentSkills format, enabling the AI-DLC workflow to be used with AgentSkills-compatible agents.
Changes
build/skills/aidlc/directory containing 30 files with the full AI-DLC ruleset converted to AgentSkills format, covering:SKILL.md— main skill entry pointcommon/— shared rules (error handling, terminology, session continuity, etc.)inception/— planning phase rules (requirements analysis, user stories, workflow planning, etc.)construction/— implementation phase rules (code generation, functional design, build & test, etc.)extensions/— opt-in extensions (security baseline, property-based testing)operations/— deployment phase rulesbuild/directory, its purpose, and a note that files should not be edited directlyUser experience
Users can consume the AI-DLC workflow through the AgentSkills standard by copying the
build/skills/aidlc/directory into their agent's skills configuration directory. For example:.claude/skills/.kiro/skills/Checklist
If your change doesn't seem to apply, please leave them unchecked.
Test Plan
build/skills/aidlc/SKILL.mdis a valid AgentSkills entry point and references all sub-rules correctlyAcknowledgment
By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.