skillpack-creator

1# Skillpack Creator
2 
3## Overview
4 
5Turn a successful task into a reusable SkillPack. Extract the stable workflow, decide what belongs in a local skill versus pack-level prompts, generate the pack structure, and package it only after the workflow is explicit and repeatable.
6 
7## Workflow
8 
9### 1. Normalize the source task
10 
11Reduce the finished task into a clean execution spec:
12 
13- Capture the user goal, concrete deliverable, and the final successful workflow (not the full exploratory transcript).
14- List required skills, tools, files, secrets, and environment assumptions.
15- Separate deterministic steps from heuristic steps; remove dead ends and debugging noise.
16- If the task is still too broad, narrow the scope instead of writing a vague mega-skill. If key success conditions depend on hidden human judgment, mark the pack as a best-effort assistant workflow.
17 
18Ask for missing stable facts or infer only the low-risk pieces.
19 
20### 2. Decide what the pack should contain
21 
22- **Local skill** (`skills/`): reusable procedural knowledge. Keep scripts minimal unless reproducibility depends on exact file generation or repetitive shell steps.
23- **Scripts** (`scripts/`): repeated shell or file-generation logic where reliability matters.
24- **References** (`references/`): detailed schemas, API notes, or conventions that should not bloat `SKILL.md`.
25…