spec-skill-moat

Generate SKILL.md files and MOAT asset files from skill design documents.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/JaviMontano/mao-plugin-qa --skill spec-skill-moat-javimontano
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-skill-moat
Source: https://github.com/JaviMontano/mao-plugin-qa/tree/main/skills/spec-skill-moat
Command: npx skills add https://github.com/JaviMontano/mao-plugin-qa --skill spec-skill-moat-javimontano

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing a well-structured SKILL.md for Claude Code plugins requires enforcing many conventions: complete YAML frontmatter, seven required body sections, a 500-line body limit, progressive disclosure, and quality scoring across six MOAT dimensions. Doing this by hand is error-prone and inconsistent. ## Core Features & Use Cases - SKILL.md Generation: Produces complete SKILL.md files with frontmatter, guiding principle, procedure steps with tool references, quality criteria, anti-patterns, and edge cases from a skill design document. - MOAT Asset Creation: Generates supporting references/, examples/, and prompts/ files based on the design's MOAT strategy. - Quality Scoring Loop: Scores output against 6 MOAT dimensions (trigger accuracy, completeness, clarity, robustness, efficiency, value density) and revises until every dimension reaches at least 7/10. - Use Case: After drafting a skill design document for a new validation skill, run this Skill to produce a production-ready SKILL.md plus reference and example files, with a MOAT score summary confirming quality thresholds. ## Quick Start Generate a SKILL.md specification from my skill design document at designs/validate-config-design.md.

Frequently Asked Questions about spec-skill-moat

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

FAQPage Schema
How do I generate a SKILL.md file for a Claude Code plugin?▼

Provide a completed skill design document containing the skill name, description, trigger phrases, procedure steps, and quality criteria. The Skill generates the full SKILL.md with frontmatter, all seven required body sections, and MOAT asset files.

What is the MOAT 6-dimension quality rubric for skills?▼

MOAT scores skills on trigger accuracy, completeness, clarity, robustness, efficiency, and value density, each on a 1-10 scale. Every dimension must reach at least 7; below-threshold dimensions are revised and re-scored until they pass.

What is the line limit for a SKILL.md file?▼

The SKILL.md body must not exceed 500 lines, excluding frontmatter. Content beyond that is extracted into references/ files using progressive disclosure, and files over 300 lines get a table of contents.

Can I generate a SKILL.md from just a brief idea?▼

No. This Skill requires a completed skill design document as input and halts if required sections are missing. Turning a brief concept into a design is the responsibility of a separate design-skill step.

What sections must a generated SKILL.md contain?▼

Seven sections are required: title, guiding principle blockquote, introduction, procedure with tool references, at least 4 quality criteria, at least 3 anti-patterns, and at least 2 edge cases.