coreyhaines31/makerskills / skills/skillify
skillify
VerifiedWhen you want to create, adapt, or update an Agent Skill (Claude Code, Codex, Cursor, and other hosts) in one of your repos (listed in ~/.config/makerskills/skillify/repos.yaml; defaults to makerskills). Modes — CREATE (from chat, video, dump, or scratch) turns a workflow into a new skill. ADAPT ports an external skill with keep/adapt/add classification, license check, and attribution. UPDATE improves existing skills from learnings with cross-skill propagation, memory-vs-skill triage, and semver. TEST role-plays users through a skill and judges transcripts against a rubric. Checks new skills for host portability. Triggers on "/skillify," "create a skill," "make this a skill," "adapt this skill," "port this skill," "update X skill," "propagate this learning," "improve [skill]," "fix [skill]," "test this skill," "exercise [skill]." Part of the -ify trifecta — integrations and MCP servers go to toolify, schedules and loops to loopify.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 22.3 KB |
| references/adapt-buckets.md | markdown | 3.5 KB |
| references/adapt-license-check.md | markdown | 3.1 KB |
| references/test-rubric.md | markdown | 8.0 KB |
| references/update-change-types.md | markdown | 4.4 KB |
| references/update-propagation.md | markdown | 5.2 KB |
| references/update-versioning.md | markdown | 3.0 KB |
references/adapt-buckets.md
View on GitHub# Three-bucket classification
When porting a skill, every piece of the source maps to one of three buckets. Surface this classification to the user **before** writing the adapted skill — never silently rewrite.
## Bucket 1: Keep verbatim
What it is: format, schema, mechanic, scripts, frameworks, regex patterns, JSON shapes, math/algorithm details.
Why: this is the *value* the source is bringing. Reinventing wastes effort and risks bugs.
Examples:
- The 38 decision questions from the 37signals decision skill
- ffmpeg flag patterns for frame extraction
- A regex for detecting URLs in a post
- A JSON schema for the output payload
- Specific API endpoints + auth patterns
- The viewport-base.css from frontend-slides
- The Karpathy LLM wiki schema rules
Action: **copy as-is**. Optionally add a `<!-- from <source> -->` marker.
## Bucket 2: Adapt
What it is: tool defaults, paths, voice, naming, opinions, user-context examples.
Why: these are the source author's preferences. Yours differ.
### Sub-buckets to look for
| Sub-bucket | Source has | Adapt to |
|---|---|---|
| **Naming** | Their convention | Verb-noun (matches `watch-video`, `read-book`, `create-skill`) when possible |
| **Tool defaults** | Their video tool | Your `watch-video` |
| | Their kanban | Your `project-manager` |
| | Their transcript tool | Your `watch-video transcript` mode |
| | Their notes / KB | Your `second-brain` (or `${SECOND_BRAIN_VAULT:-$HOME/Documents/SecondBrain}/`) |
| | Their decision framework | Your `decide` |
| | Their social drafting | Your `jab-hook` |
| | Their research | Your `deep-research` |
| **Paths** | `~/outputs/` or `~/notes/` | `~/Documents/<skill>-<...>` convention |
| | Custom config dirs | Your `references/` pattern |
| **Voice** | Generic / corporate / theirs | Yours — direct, conviction-coded, listener-perspective, no AI-slop |
| **Context** | "The user," generic examples | Your specific context (your name, your products / portfolio / partnerships) where the skill needs it |
| **Defaults** | Their assumed environment | Your Mac, MLX-Whisper, brew, uv, Notion API key, Typefully MCP, etc. |
| **Cadence** | Their suggested frequency / WIP limits | Yours (e.g., 2 promo/week for social, 3 In-Progress WIP for project-manager) |
Action: **rewrite** the affected lines, surface the change in the bucket report.
## Bucket 3: Add
What it is: cross-references, composition notes, your conventions that the source doesn't know about.
Why: the source is generic; your version sits in a network of other skills.
Examples:
- "Composes with `decide`" (when the skill hits a decision moment)
- "Outputs to `second-brain raw/` as `<prefix>-`"
- "Falls back to `social-fetch` for the URL fetch step"
- "Uses MLX-Whisper local (see install in `watch-video` references)"
- Memory references: `feedback_*` files in the user's memory store (agent memory, or `$MAKERSKILLS_MEMORY`)
- BACKLOG.md entry if the adapt spawns sub-ideas
Action: **add net-new sections** to the adapted SKILL.md — typically a `## Composes with` section and inline references in the body.
## Bucket report format
Present to the user before writing:
```markdown
## Three-bucket classification — <source skill name>
### Keep verbatim
- <piece 1>
- <piece 2>
### Adapt
- <source piece> → <new version> (why: <reason>)
- <source piece> → <new version> (why: <reason>)
### Add
- <new piece> (compose with `<your skill>`)
- <new piece>
**Proceed?** y/n / edit
```
the user approves, edits, or rejects. Only then proceed to write the adapted SKILL.md.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |