skill-architect

Scaffold, audit, and refine Agent Skills metadata in SKILL.md files.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/scanady/nexus-agents --skill skill-architect-scanady
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-architect
Source: https://github.com/scanady/nexus-agents/tree/main/.agents/skills/skill-architect
Command: npx skills add https://github.com/scanady/nexus-agents --skill skill-architect-scanady

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Full lifecycle management for Agent Skills — scaffold a new skill, review an existing SKILL.md for spec compliance and routing quality, or refine metadata. Use when asked to "create a skill", "build a skill", "scaffold a skill", "review a skill", "audit a skill", "improve a skill", "optimize skill triggers", "fix skill description", or "update skill frontmatter". Covers archetype classification, description and trigger optimization, collision detection against neighbor skills, and metadata routing. Use whenever the user is authoring or editing a SKILL.md file.

Core Features & Use Cases

  • Scaffold a new skill with a clean SKILL.md frontmatter and references structure.
  • Validate SKILL.md for spec compliance, frontmatter rules, and routing quality.
  • Optimize metadata routing to improve discoverability and reduce collisions.

Quick Start

Start by outlining the skill goal, then run a review pass against the current SKILL.md to identify gaps.

Frequently Asked Questions about skill-architect

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

FAQPage Schema
How do I scaffold a new Agent Skill from scratch?

Skill routing metadata is managed through frontmatter fields in SKILL.md files, optimized to improve discoverability and reduce collisions against neighbor skills across platforms.

How do I validate a SKILL.md file for spec compliance?

You validate a SKILL.md file by running an audit pass that checks frontmatter rules, routing quality, and archetype classification to identify gaps and ensure the skill meets specification standards.

How can I fix skill description triggers to prevent routing collisions?

Fix skill description triggers by refining metadata routing and optimizing frontmatter, which reduces collisions against neighbor skills and improves cross-platform discoverability.

What is Agent Skill lifecycle management and when do I need it?

Agent Skill lifecycle management is the end-to-end process of scaffolding, auditing, and refining SKILL.md files for spec compliance and routing quality, needed whenever authoring or editing a skill.

What's the best way to optimize skill frontmatter for better discoverability?

The best way to optimize skill frontmatter is refining metadata routing and trigger descriptions, ensuring archetype classification aligns with the skill's core task to maximize discoverability.

Why does my Agent Skill have poor routing quality and trigger collisions?

Poor routing quality and trigger collisions occur when SKILL.md frontmatter metadata is not optimized, requiring an audit pass to refine descriptions and reduce overlap with neighbor skills.