service-validate

Validate service documentation frontmatter, sections, and API/Data Model references.

31|5|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/NSEvteev/FullSpec --skill service-validate-nsevteev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: service-validate
Source: https://github.com/NSEvteev/FullSpec/tree/main/.claude/skills/service-validate
Command: npx skills add https://github.com/NSEvteev/FullSpec --skill service-validate-nsevteev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many teams struggle to ensure service specifications and documentation stay aligned with defined standards, leading to inconsistent frontmatter and missing API/Data Model details.

Core Features & Use Cases

  • Frontmatter validation for service docs ensuring required fields like name and description.
  • Structural checks for mandatory sections (autonomy, changelog) and API/Data Model subsections.
  • Pre-commit, review, and new-service workflows to enforce documentation quality.

Quick Start

Run /service-validate [service-name | --all] to validate documentation against the standard.

Frequently Asked Questions about service-validate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate service documentation against project standards?

To validate service documentation, run a check against your project standard to ensure proper frontmatter, mandatory sections like changelog and autonomy notes, and API/Data Model subsections. You can target a single service by name or all services at once.

What sections are required in a service spec to pass documentation validation?

Documentation validation requires a completed frontmatter with name and description, a changelog section, autonomy notes, and API/Data Model references. Your service spec must include all these mandatory subsections to meet the standard.

Can I check all service docs at once instead of validating them one by one?

Yes, you can check all service docs at once by running the validation command with the --all flag. This iterates through every service specification file in your directory to enforce consistent frontmatter and structural compliance.

When should I run service documentation validation in my development workflow?

You should run service documentation validation during pre-commit checks, code reviews, or new service creation workflows. This ensures consistent frontmatter fields and API/Data Model details before changes are merged into the main branch.

Does documentation validation check for missing API and Data Model references?

Yes, documentation validation explicitly checks for missing API and Data Model references. It enforces the presence of these subsections within your service spec to ensure all technical interface details are properly documented.