design-skill

Designs complete SKILL.md specifications with frontmatter, procedures, quality criteria, and edge cases.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing a well-structured Claude Code plugin skill requires knowing the full frontmatter field catalog, procedure conventions, and quality standards. This Skill turns a rough skill concept into a complete, review-ready SKILL.md design document that follows the official spec and MOAT quality dimensions. ## Core Features & Use Cases - Full frontmatter drafting: Generates YAML frontmatter using all official fields (name, description, argument-hint, allowed-tools, model, hooks, and more) with least-privilege tool selection. - Structured procedure design: Produces 5-10 numbered steps with action verbs, inputs, outputs, and evidence tags, plus quality criteria, anti-patterns, and edge cases. - MOAT quality validation: Scores the design against Completeness, Accuracy, Actionability, and Maintainability before presentation. - Use Case: You are building a devops plugin and need a new lint-dockerfile skill. Provide the concept, and this Skill outputs a complete SKILL.md specification including trigger phrases, a guiding principle quote, testable quality criteria, and documented edge cases. ## Quick Start Ask the AI to design a skill named lint-dockerfile for your plugin, including frontmatter, procedure steps, quality criteria, anti-patterns, and edge cases.

Frequently Asked Questions about design-skill

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

FAQPage Schema
How do I design a Claude Code plugin skill?▼

Provide the skill name and concept, and this Skill produces a complete SKILL.md design: YAML frontmatter with all official fields, a 5-10 step procedure with inputs and outputs, testable quality criteria, anti-patterns, and edge cases. The file is written only after your confirmation.

What fields are required in SKILL.md frontmatter?▼

Only name and description are required. Optional fields include argument-hint, allowed-tools, disable-model-invocation, user-invocable, model, context, agent, and hooks. The name must be kebab-case and match the skill's directory name.

How do I choose allowed-tools for a skill?▼

Apply least privilege: read-only skills use Read, Glob, and Grep; analysis skills add Bash; generation skills add Write. Never include Write for a read-only skill, and document the rationale for each tool included.

Does this Skill write the final SKILL.md file automatically?▼

No. It produces a design specification for review, including a metadata summary with line count, tools, MOAT depth, and quality score. The file is written only after explicit user confirmation.

What are the limitations of the skill design output?▼

The MOAT scoring is a self-assessment, not an external audit, and the Skill cannot verify that procedure steps are actually executable, only that they are structurally correct with action verbs, inputs, and outputs.