Agent skill

Spec Linter

Validates specs have required frontmatter, links, and compliance. Use before commits or during code review.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/spec-linter

SKILL.md

Spec Linter Skill

Purpose

Validate:

  • Frontmatter completeness
  • Test-to-spec traceability
  • ADR requirements for architectural changes
  • PR template compliance

Validation Rules

  1. Frontmatter required fields by type
  2. Test IDs (TC-XXX) present near Swift test methods
  3. ADR required when key components/frameworks change
  4. Acceptance criteria present for new features
  5. PR template sections completed

Usage

  • Pre-commit: python3 scripts/lint-specs.py
  • CI: see .github/workflows/spec-lint.yml

Didn't find tool you were looking for?

Be as detailed as possible for better results