scaffold

Generate agent or skill templates that conform to schemas and update state.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/ysgdepaula/x-deep-os --skill scaffold-ysgdepaula
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scaffold
Source: https://github.com/ysgdepaula/x-deep-os/tree/main/.claude/skills/scaffold
Command: npx skills add https://github.com/ysgdepaula/x-deep-os --skill scaffold-ysgdepaula

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates agent and skill scaffolds that conform to shared schemas, updates state, and maintains CLAUDE.md hierarchy to accelerate onboarding.

Core Features & Use Cases

  • Agent/Skill template generation: Creates .claude/skills/<verb-noun>/SKILL.md for skills or agent templates for new agents, while updating state.json.
  • Schema validation & consistency: Ensures frontmatter and file structure adhere to .agent/schemas/ definitions and related validators.
  • Documentation & PR readiness: Updates CLAUDE.md hierarchy and prepares artifacts for PR workflows.
  • Batch scaffolding support: Handles multiple artifacts in a single operation when provided.

Quick Start

Provide the artifact type and name to scaffold, and the tool will generate the template and update state.json and CLAUDE.md.

Frequently Asked Questions about scaffold

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

FAQPage Schema
How do I generate agent or skill templates that comply with existing schemas?

To generate agent or skill templates, provide the artifact type and name to scaffold. The system creates the required YAML or folder structure, validates frontmatter against schemas, and updates state.json.

What's the best way to scaffold multiple agent or skill templates at once?

Batch scaffolding is supported natively, allowing you to handle multiple artifact templates in a single operation. This enables you to generate several skills or agents while updating the central state and documentation hierarchy simultaneously.

How does scaffolding update the CLAUDE.md documentation hierarchy?

Scaffolding updates the CLAUDE.md documentation hierarchy automatically when a new agent or skill template is created. This maintains the project's documentation structure and prepares the artifacts for PR workflows.

Do I need to manually validate frontmatter fields when creating new skills?

No, manual validation is unnecessary because the scaffolding process enforces required frontmatter fields and validates them against .agent/schemas/ definitions. It surfaces validation results for your review automatically.

Can I use this scaffolding approach for both agents and skills?

Yes, scaffolding is scoped for both agents and skills. It handles agent template YAML generation and skill folder creation at .claude/skills/<verb-noun>/SKILL.md, ensuring both comply with shared schemas.

Why does creating a new skill template require updating state.json?

Updating state.json is required to maintain central state consistency when new templates are added. This mutation tracks the newly scaffolded agents or skills, ensuring the project's state remains synchronized.