kata-init-skill

Scaffold external skill project directories from framework templates with placeholder substitution.

Updated Sep 3, 2025
One-click install
npx skills add https://github.com/guardiatechnology/design-system --skill kata-init-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kata-init-skill
Source: https://github.com/guardiatechnology/design-system/tree/main/.claude/skills/kata-init-skill
Command: npx skills add https://github.com/guardiatechnology/design-system --skill kata-init-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating a new skill project from scratch is slow and inconsistent, so this kata provides a repeatable way to scaffold the correct directory structure and configuration from the framework template.

Core Features & Use Cases

  • Slug validation & safety checks: Enforces a strict slug format, rejects reserved words, and validates description length to prevent invalid project metadata.
  • Deterministic project scaffolding: Copies the framework skill-project-sample template into skills/{slug}/ (or the configured root) and replaces placeholders consistently (slug, language, title, license).
  • Configurable opt-outs: Can remove or tailor widgets/, tools/, and scripts/ based on flags, including selecting JS runtime for scripts.
  • Guardrails & validation: Refuses to overwrite existing destinations, updates .gitignore to include the build output folder when missing, and verifies that the generated SKILL.md and skill.config.json exist and contain no leftover placeholders.

Quick Start

Have the AI run /cry-new-skill with a valid slug and description to generate a new project at {paths.skills_root}/{slug}/ from the template, optionally applying the widgets/tools/scripts opt-outs.

Frequently Asked Questions about kata-init-skill

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

FAQPage Schema
How do I scaffold a new skill project directory from a template?

To scaffold a new skill project directory, run the initialization command with a valid slug and description to copy the framework template into the target path. The process enforces strict slug validation, replaces placeholders, and generates the required configuration files.

What is project scaffolding and placeholder substitution for skill templates?

Project scaffolding for skill templates is the process of copying a framework sample directory and performing placeholder substitution to replace variables like slug, language, and title. This ensures new skill projects have a consistent, valid directory structure and configuration from the start.

Can I configure the project initialization to exclude widgets, tools, and scripts?

Yes, you can configure project initialization to exclude widgets, tools, and scripts using optional flags. The scaffolding process can remove these directories or tailor their contents based on your specified configuration, including selecting the JS runtime for scripts.

Does the skill scaffolding process overwrite existing project directories?

No, skill scaffolding refuses to overwrite existing project directories to guarantee safety. The process enforces non-overwrite rules by validating destination paths before copying the template, ensuring existing projects remain intact during initialization.

How does directory structure validation check for unresolved placeholders?

Directory structure validation checks for unresolved placeholders by verifying the generated project contains SKILL.md and skill.config.json files. It scans these files to ensure no leftover __...__ placeholder patterns remain after the substitution process completes.

Why does the scaffolding tool update the .gitignore file during project initialization?

The scaffolding tool updates the .gitignore file during project initialization to include the build output folder when missing. This ensures the generated directory structure maintains correct version control exclusions automatically after template copying.