stitch-skill-creator

Stitch Skill Creator

A factory for creating new stitch-kit skills. Enforces standard structure, naming conventions, and the plugin's architectural patterns.

When to use this skill

• Adding support for a new framework (e.g. "Astro", "Qwik", "Flutter")
• Creating a domain-specific prompt architect (e.g. stitch-ui-ecommerce-architect)
• Adding a new quality tool (e.g. stitch-performance, stitch-seo)
• Any time you need a new SKILL.md that integrates with the stitch-kit ecosystem

---

Naming conventions

Skill type	Name pattern	Example
Framework conversion	stitch-[framework]-components	stitch-astro-components
Domain prompt architect	stitch-ui-[domain]-architect	stitch-ui-ecommerce-architect
MCP wrapper	stitch-mcp-[tool-name]	stitch-mcp-edit-screen
Quality / analysis tool	stitch-[capability]	stitch-performance
Meta / utility	stitch-[name]	stitch-setup

Rules:

• Always kebab-case
• Always starts with stitch-
• Framework conversion skills end with -components
• MCP wrappers follow stitch-mcp-{snake_case_tool → kebab} from docs/mcp-naming-convention.md

---

Required directory structure

skills/[skill-name]/
├── SKILL.md              ← Required: frontmatter + workflow (keep under 500 lines)
├── examples/
│   └── usage.md          ← Required: 2+ worked examples
├── resources/            ← Optional: templates, checklists, reference tables
│   ├── component-template.[ext]
│   └── architecture-checklist.md
├── scripts/              ← Optional: bash scripts
│   └── fetch-stitch.sh   ← Copy from stitch-mcp-get-screen/scripts/ if needed
└── references/           ← Optional: style guides, contracts, long reference docs

---

SKILL.md template

---
name: stitch-[skill-name]
description: [One clear sentence — when to use this skill and what it does. This is used for routing by the orchestrator and for marketplace display.]
allowed-tools:
  - "stitch*:*"   # Include if skill calls Stitch MCP tools
  - "Bash"        # Include if skill runs shell commands
  - "Read"        # Usually yes
  - "Write"       # Usually yes
---

# Stitch → [Target] [Type]

**Constraint:** Only use this skill when the user explicitly mentions "Stitch" [and any additional trigger condition].

[One sentence explaining what this skill does and who the agent "is" while using it.]

## When to use this skill vs. similar skills

[Table comparing this skill to its nearest alternatives — help the orchestrator route correctly]

## Prerequisites

[What the user/environment needs before this skill can run]

## Step 1: Retrieve the design

1. Run `list_tools` → find Stitch MCP prefix
2. Call `[prefix]:get_screen` with numeric `projectId` and `screenId`
3. Download HTML: `bash scripts/fetch-stitch.sh "[htmlCode.downloadUrl]" "temp/source.html"`

## Step 2: [Core conversion / workflow]

[The main logic of this skill]

## Step N: Output

[What the skill produces — files, code, commands]

## Troubleshooting

| Issue | Fix |
|-------|-----|

## References

- `resources/component-template.[ext]` — [description]
- `resources/architecture-checklist.md` — Pre-ship checklist
- `scripts/fetch-stitch.sh` — Reliable GCS HTML downloader