Our review
Creates Markdown specification files in a specs/ directory to document recently completed work during a session.
Strengths
- Automates post-development documentation
- Clear structure with standardized sections
- Supports various types (features, architecture, immersive)
- Auto-updates related README files
Limitations
- Requires a meaningful conversation history to extract details
- Does not cover pre-existing code outside the session
At the end of a development session to capture implementation decisions and details.
If no significant work was done or if documentation is maintained in an external tool.
Security analysis
SafeThe skill only provides instructions for the AI to generate documentation files; it does not execute commands, manipulate sensitive data, or interact with external systems.
No concerns found
Examples
/spec/spec user-authentication/spec immersivename: spec description: Document recently completed work by creating spec .md files in specs/ directory
/spec - Document Recently Completed Work
Create specification documentation for recently completed work in this session.
Instructions
When the user invokes /spec, you should:
-
Review the conversation to identify what was recently built, fixed, or modified
-
Determine the appropriate spec type based on the work:
- Immersive experience → Create in
specs/immersive/ - New feature/flow → Create in
specs/features/ - Architecture change → Update
specs/architecture.md - General spec → Create in
specs/
- Immersive experience → Create in
-
Create the spec file with this structure:
# [Feature Name] **File(s):** `path/to/file.swift` **Type:** [View | Manager | Component | Flow] **Purpose:** One-line description --- ## Overview Brief description of what this does and why it exists. ## Implementation Key code patterns, setup, and usage. ## Integration Points How this connects to other parts of the codebase. ## Usage Example Code snippets showing how to use this feature. -
For immersive/RealityView specs, include:
- RealityView structure (content, update, attachments)
- 3D entities created/modified
- ARKit integration (hand tracking, image tracking)
- Collision detection setup
- Attachment positions and sizes
-
Update the relevant README.md if adding to a subdirectory
Arguments
/spec [name]- Create spec with specific name/spec immersive- Force creation in specs/immersive//spec update- Update existing spec files based on recent changes
API Documentation Generator
Documentation
Automatically generates OpenAPI/Swagger API documentation.
Technical Writer
Documentation
Writes clear technical documentation following top style guides.
Technical Documentation Architect
Documentation
Analyzes existing codebases to produce comprehensive technical documentation (10-100+ pages), including architecture overviews, design decisions, and troubleshooting guides. Best used for system documentation, architecture guides, or technical deep-dives.