rakovi4/api-spec
.claude/skills/api-spec/SKILL.md
Generate OpenAPI specifications for story endpoints. Use when user wants to create API specs for a story or mentions /api-spec command.
$ install --global
skillsauthnpx skillsauth add rakovi4/continue-example api-specInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 1:19 AM7.5s1 file scanned
SKILL.md
- name:
- api-spec
- description:
- Generate OpenAPI specifications for story endpoints. Use when user wants to create API specs for a story or mentions /api-spec command.
Generate API Specification
Generate OpenAPI 3.0.3 specifications for frontend endpoints in a story.
Usage
/api-spec "Story name"
/api-spec 5 # By MVP story number
/api-spec # Interactive selection
MVP Mindset
Generate the MINIMUM viable API, not the complete API.
- Prefer fewer endpoints - consolidate where possible
- No health/status endpoints (infrastructure, not features)
- No separate replace endpoints (use PUT on same resource)
- No separate "get current state" if POST response returns it
- When in doubt, leave it out
Workflow
Phase 1: Context & Story Selection
-
Read context files:
ProductSpecification/BriefProductDescription.txtProductSpecification/stories.mdProductSpecification/stories/*/mockups/(UI mockups)ProductSpecification/stories/*/interview.md(if exists — authoritative source for API details)
-
Parse user input to find target story (by name, number, or interactive)
-
Read story specification:
ProductSpecification/stories/NN-story-name/NN_StoryName.md
Phase 2: Generate Specifications
Load .claude/templates/spec/api-spec-template.md for document formats.
Based on story and mockups, identify the minimum endpoints needed.
- Create
endpoints.mdin story folder - Create OpenAPI YAML in
ProductSpecification/api-specs/[resource]_[action].yaml
Phase 3: Summary
Report: created files, endpoints generated, design decisions.
Design Constraints
- OpenAPI version: 3.0.3 (YAML format)
- API versioning:
/api/v1/prefix - Naming: snake_case files, kebab-case URLs
- RESTful: Follow REST conventions
- Minimal responses: Only essential fields
- Check if spec already exists before creating
Related Skills
rakovi4/test-usecase
testing
VerifiedTrustedCommunity
Run use-case module tests quickly. Use when user wants to run use-case tests or mentions /test-usecase command.
2SKILL.mdUpdated Apr 16, 2026
rakovi4/test-spec
development
VerifiedTrustedCommunity
Generate BDD test specifications for story in 6 categories (API, UI, Load, Infrastructure, Security, Integration). Use when user wants to create test cases or mentions /test-spec command.
2SKILL.mdUpdated Apr 16, 2026
rakovi4/test-review
testing
VerifiedTrustedCommunity
Review tests to replace loose validation (contains, isNotNull, isNotEmpty) with strict validation (isEqualTo on parsed fields). Use when user wants to improve test assertions or mentions /test-review command.
2SKILL.mdUpdated Apr 16, 2026
rakovi4/test-frontend
development
VerifiedTrustedCommunity
Run frontend tests. Use when user wants to run frontend unit tests or mentions /test-frontend command.
2SKILL.mdUpdated Apr 16, 2026