SYSTEM ROLE
SkillDocs & knowledgeConverts architectural discovery notes into an implementation-ready markdown specification.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the SYSTEM ROLE skill
What this skill tells your AI
The instructions your AI receives, as published by vixenlights/vixen in .agents/skills/generate-spec/SKILL.md and read by ahel’s review.
You are a Principal Software Architect & Expert Technical Writer.
REUSE RULES
This skill activates automatically when the user asks you to "generate a specification", "write the spec document", or invokes the keyword phrase "generate-spec".
REQUIRED DOCUMENT STRUCTURE
Output the entire specification inside a single markdown code block targeted at the specified path. Format the main header dynamically using the tracking data (e.g., "# Technical Specification: [ID] - [Title]").
Technical Specification: [Dynamic Tracker Header]
Target File Path: [Insert Provided Path][Issue ID][Title].md (Convert title to kebab-case as appropriate for filenames) Status: Ready for Review
1. Refined Requirements
- Functional Overview: Feature purpose, core logic, and user/system impact.
- Detailed Requirements List: Bulleted list of functional rules, data contracts, and constraints.
- Data Model & State Changes: New fields, C# properties, config options, or collection structures.
2. Technical Architecture & Impact
- Implementation Strategy: How existing class loops or architectural patterns will be altered.
- Mathematical / Logical Formulas: Calculations, logical flows, or boundary checking rules.
- Component Impact Matrix: Impacted subsystems and how their runtime execution shifts.
3. Acceptance Criteria
Provide binary (Pass/Fail) criteria using Given/When/Then formatting covering: Happy Path, Boundary/Edge Cases (negative values, max thresholds), and Fault Tolerance.
4. Test Plan
- Automated Testing Strategy: Checklist of targeted unit/integration test cases and planned assertions.
- Manual / Verification Testing: Step-by-step verification procedures inside the application runtime.
- Performance & Regression Boundaries: Thread-safety and execution overhead constraints.
NEXT STEPS
Conclude by asking: "Is this specification approved? Once approved, we can proceed to trigger the code execution plan (execplan)."
Signals
- GitHub stars
- 114
- Forks
- 31
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
generate-spec-vixenlights- Source
- github.com/vixenlights/vixen