skill-architect

Guides structured design, authoring, and validation of new SKILL.md skill units.

Updated Sep 15, 2026
One-click install
npx skills add https://github.com/Peterson-Benhame/agent-skills --skill skill-architect-peterson-benhame
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-architect
Source: https://github.com/Peterson-Benhame/agent-skills/tree/main/packages/skills-catalog/skills/%28creation%29/skill-architect
Command: npx skills add https://github.com/Peterson-Benhame/agent-skills --skill skill-architect-peterson-benhame

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve? Creating a well-formed agent skill is error-prone: descriptions undertrigger, instructions are vague, and structural rules (kebab-case names, frontmatter format, no README) are easy to miss. This Skill walks you through a disciplined Discovery → Architecture → Craft → Validate → Deliver workflow so the resulting skill triggers correctly and behaves consistently. ## Core Features & Use Cases - Structured Discovery & Architecture: Defines use cases, trigger phrases, success criteria, and selects from five proven workflow patterns (sequential, multi-MCP, iterative refinement, context-aware selection, domain intelligence) before writing any code. - Craft Guidance with Anti-Patterns: Enforces frontmatter hard rules, progressive disclosure across SKILL.md and reference files, and provides good/bad description and instruction examples. - Automated Validation: Runs scripts/validate_skill.py to check folder naming, frontmatter fields, description triggers, and body quality, producing human or JSON reports. - Use Case: You say "turn this deployment checklist into a skill" — the Skill extracts the workflow from context, drafts a description with trigger phrases, writes the SKILL.md, and validates it before delivery. ## Quick Start Ask the agent to help you create a new skill for a workflow you want to automate, and answer its discovery questions.

Frequently Asked Questions about skill-architect

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

FAQPage Schema
How do I create a new agent skill with a SKILL.md file?

Follow the five-phase workflow: Discovery to define use cases and triggers, Architecture to pick a pattern and draft the description, Craft to write frontmatter and instructions, Validate with the included script, then Deliver the packaged folder.

What makes a good skill description for trigger accuracy?

A good description combines what the skill does, specific phrases users would say to trigger it, and negative triggers stating what it should not handle. Keep it under 1024 characters, on a single line, with no XML angle brackets.

How do I validate a skill folder structure?

Run scripts/validate_skill.py against the skill folder. It checks SKILL.md casing, kebab-case naming, frontmatter fields, description triggers, absence of README.md, and body quality, exiting nonzero on errors.

Does the validation script require PyYAML?

No. PyYAML is optional; the script falls back to a stdlib parser supporting a conservative YAML subset. Installing PyYAML enables full YAML support for more complex frontmatter.

When should I not use this skill?

Do not use it for creating subagents, writing technical design documents, or improving and benchmarking existing skills. It is strictly for designing and building new skills from scratch.