{"id":50084240,"url":"https://github.com/redhuntlabs/wizard","last_synced_at":"2026-06-21T14:30:22.655Z","repository":{"id":352554731,"uuid":"1215098585","full_name":"redhuntlabs/wizard","owner":"redhuntlabs","description":"Build AI spells for what you do - a meta-builder that turns recurring tasks into reusable workflows that any AI assistant can run.","archived":false,"fork":false,"pushed_at":"2026-04-24T07:19:46.000Z","size":2086,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-26T23:05:13.711Z","etag":null,"topics":["ai-agents","ai-skills","ai-tools","ai-workflow","automation","claude-code","claude-code-plugin","copilot-cli","cursor","cursor-plugin","developer-tools","gemini-cli","meta-framework","productivity","prompt-engineering"],"latest_commit_sha":null,"homepage":"https://github.com/redhuntlabs/wizard#readme","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/redhuntlabs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-19T13:32:40.000Z","updated_at":"2026-05-14T08:42:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/redhuntlabs/wizard","commit_stats":null,"previous_names":["redhuntlabs/superpower-builder","redhuntlabs/wizard"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/redhuntlabs/wizard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhuntlabs%2Fwizard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhuntlabs%2Fwizard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhuntlabs%2Fwizard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhuntlabs%2Fwizard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/redhuntlabs","download_url":"https://codeload.github.com/redhuntlabs/wizard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhuntlabs%2Fwizard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34612948,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-skills","ai-tools","ai-workflow","automation","claude-code","claude-code-plugin","copilot-cli","cursor","cursor-plugin","developer-tools","gemini-cli","meta-framework","productivity","prompt-engineering"],"created_at":"2026-05-22T18:00:36.857Z","updated_at":"2026-06-21T14:30:22.639Z","avatar_url":"https://github.com/redhuntlabs.png","language":"JavaScript","funding_links":[],"categories":["Skills","Plugins"],"sub_categories":["Community Skills","Utilities"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/hero-banner.svg\" alt=\"Wizard\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003eBuild AI spells for what you do.\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  Your AI wizard — every task you do twice becomes a spell you can cast in any tool. \u003cbr/\u003e\n  Runs in \u003cstrong\u003eClaude Code\u003c/strong\u003e, \u003cstrong\u003eCursor\u003c/strong\u003e, \u003cstrong\u003eCodex\u003c/strong\u003e, \u003cstrong\u003eGemini\u003c/strong\u003e, \u003cstrong\u003eOpenCode\u003c/strong\u003e, and \u003cstrong\u003eCopilot CLI\u003c/strong\u003e.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/badge/license-MIT-9d7bff.svg?style=flat-square\"\u003e\u003c/a\u003e\n  \u003cimg alt=\"Node 18+\" src=\"https://img.shields.io/badge/node-%3E=18-7afcff.svg?style=flat-square\"\u003e\n  \u003cimg alt=\"Spells bundled\" src=\"https://img.shields.io/badge/spells-37%20bundled-ff7ad9.svg?style=flat-square\"\n       title=\"25 spells + 12 framework skills\"\u003e\n  \u003cimg alt=\"Status: V1\" src=\"https://img.shields.io/badge/status-v1.0.0-28c840.svg?style=flat-square\"\u003e\n  \u003cimg alt=\"No telemetry\" src=\"https://img.shields.io/badge/telemetry-none-1a1b26.svg?style=flat-square\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003e\n    \u003cb\u003e25\u003c/b\u003e spells \u0026nbsp;·\u0026nbsp;\n    \u003cb\u003e12\u003c/b\u003e framework skills \u0026nbsp;·\u0026nbsp;\n    \u003cb\u003e12\u003c/b\u003e workflow shapes \u0026nbsp;·\u0026nbsp;\n    \u003cb\u003e6\u003c/b\u003e AI tools \u0026nbsp;·\u0026nbsp;\n    \u003cb\u003e0\u003c/b\u003e telemetry\n  \u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003e\n    Maintained by \u003ca href=\"https://redhuntlabs.com/\"\u003e\u003cb\u003eRedHunt Labs\u003c/b\u003e\u003c/a\u003e\n  \u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/demo.svg\" alt=\"Demo: building a spell in under a minute\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#install\"\u003eInstall\u003c/a\u003e \u0026nbsp;·\u0026nbsp;\n  \u003ca href=\"#your-first-5-minutes\"\u003eQuick start\u003c/a\u003e \u0026nbsp;·\u0026nbsp;\n  \u003ca href=\"#whats-in-the-box\"\u003eLibrary\u003c/a\u003e \u0026nbsp;·\u0026nbsp;\n  \u003ca href=\"#slash-commands\"\u003eCommands\u003c/a\u003e \u0026nbsp;·\u0026nbsp;\n  \u003ca href=\"#documentation\"\u003eDocs\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## What it is\n\nYour AI assistant is good at one-off tasks. It is **much better** when you give it a recipe to follow.\n\nAt its core, Wizard is **a meta-builder** — it turns the way *you* already work into reusable spells your AI assistant can cast on demand. Around that core it ships three more things:\n\n\u003e **A meta-builder** that interviews you and turns your recurring tasks into your own spells, saved to a personal library. *(The main act.)*\n\u003e\n\u003e **Capture a chat that worked** — `/capture-this-chat` reads the current AI session and turns it into a draft spell in one command. Or use `/build-spell --from-transcript \u003cpath\u003e` for a saved transcript from any source.\n\u003e\n\u003e **A spellbook** of 25+ ready-to-use spells — for emails, research, decisions, planning, status updates, dev workflows, and more.\n\u003e\n\u003e **A multi-tool plugin** that runs the same skills in every major AI coding tool — install once, use anywhere.\n\n## Why it exists\n\n| Problem | What this fixes |\n|---|---|\n| You re-explain the same task to the AI every time | Spells are reusable recipes the AI loads automatically |\n| Prompts work in one tool, break in another | One skill format runs in 6 different AI tools |\n| The AI is great at code but useless at *your* work | Spells cover research, writing, decisions, daily tasks |\n| You want the AI to follow a discipline (no shipping without tests, no citing without verifying) | Discipline-kind spells enforce non-negotiable rules with hard gates |\n| You hand-write the same workflow as a system prompt over and over | The meta-builder interviews you once and ships a tested spell |\n\n## Is this for you?\n\n| If you are... | You probably want... |\n|---|---|\n| **A researcher / writer / analyst** | The `research/` track — `literature-scan`, `interview-synthesis`, `verifying-before-citing`, and the `general-research-loop` chain |\n| **A knowledge worker** | The `work/` track — `preparing-for-a-meeting`, `writing-a-status-update`, `responding-to-feedback` |\n| **An everyday user** | The `everyday/` track — `writing-an-email`, `summarizing-a-document`, `planning-a-trip`, `troubleshooting-whats-not-working` |\n| **A developer** | The `dev/` track — `brainstorming-a-feature`, `writing-an-implementation-plan`, `executing-a-plan-step-by-step`, plus the `dev-tdd-loop` chain |\n| **Building a custom workflow** | The meta-builder. Type `/build-spell` and answer 5-15 minutes of questions. |\n\nTailored 5-minute intros: [for-non-devs.md](docs/for-non-devs.md) · [for-devs.md](docs/for-devs.md)\n\n---\n\n## Install\n\nPick the AI tool you already use. Each install is one or two commands.\n\n\u003e **Quickest path (Claude Code or Copilot CLI):**\n\u003e ```\n\u003e /plugin marketplace add redhuntlabs/wizard\n\u003e /plugin install wizard@wizard\n\u003e ```\n\u003e Other tools below.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClaude Code\u003c/b\u003e\u003c/summary\u003e\n\n**Recommended (one command, no clone needed):**\n\n```\n/plugin marketplace add redhuntlabs/wizard\n/plugin install wizard@wizard\n```\n\n**Or install from a local clone:**\n\n```bash\ngit clone https://github.com/redhuntlabs/wizard.git\n```\n\n```\n/plugin install \u003cpath-to-cloned-repo\u003e\n```\n\nThe boot skill loads automatically via [hooks/hooks.json](hooks/hooks.json) on every session start.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCursor\u003c/b\u003e\u003c/summary\u003e\n\n```bash\ngit clone https://github.com/redhuntlabs/wizard.git\n```\n\nIn Cursor: `Settings → Plugins → Install from path` → select the cloned folder.\n\nThe descriptor lives at [.cursor-plugin/plugin.json](.cursor-plugin/plugin.json).\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCodex CLI\u003c/b\u003e\u003c/summary\u003e\n\n```bash\ngit clone https://github.com/redhuntlabs/wizard.git ~/wizard\ncd ~/wizard \u0026\u0026 npm install\n```\n\nAdd to `~/.codex/AGENTS.md`:\n\n```markdown\n@~/wizard/AGENTS.md\n```\n\nFull instructions: [.codex/INSTALL.md](.codex/INSTALL.md)\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eGemini CLI\u003c/b\u003e\u003c/summary\u003e\n\n```bash\ngemini extensions install \u003cpath-to-cloned-repo\u003e\n```\n\nTool-name mapping: [GEMINI.md](GEMINI.md). Descriptor: [gemini-extension.json](gemini-extension.json).\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eOpenCode\u003c/b\u003e\u003c/summary\u003e\n\nIn `opencode.json`:\n\n```json\n{\n  \"plugins\": [\"\u003cpath-to-cloned-repo\u003e/.opencode/plugins/wizard.js\"]\n}\n```\n\nFull instructions: [.opencode/INSTALL.md](.opencode/INSTALL.md)\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eGitHub Copilot CLI\u003c/b\u003e\u003c/summary\u003e\n\n**Recommended (one command, no clone needed):**\n\n```bash\ncopilot plugin marketplace add redhuntlabs/wizard\ncopilot plugin install wizard@wizard\n```\n\n**Fallback (older Copilot CLI without plugin support):** clone the repo and add to your project's or home directory's `AGENTS.md`:\n\n```markdown\n@\u003cpath-to-cloned-repo\u003e/AGENTS.md\n```\n\nThen ensure scripts are runnable: `cd \u003cpath-to-cloned-repo\u003e \u0026\u0026 npm install`. If slash commands aren't supported in your version, ask in plain English: \"build a spell for me.\"\n\u003c/details\u003e\n\n---\n\n## Your first 5 minutes\n\n**1. Cast a bundled spell.**\n\n```\nCast the writing-an-email spell to draft a reply to my landlord\nsaying I'll be 3 days late on rent because of a paycheck delay.\n```\n\n**2. Build your own.**\n\n```\n/build-spell\n```\n\nThe meta-builder interviews you (5-15 minutes), drafts a SKILL.md, runs a try-it test, and saves it to `~/.wizard/`.\n\n**3. Browse what shipped.**\n\n```\n/list-spells\n```\n\nFilter by `--kind discipline`, `--audience researcher`, or `--updates`.\n\n---\n\n## What's in the box\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd valign=\"top\" width=\"33%\"\u003e\n\n### 🌱 Everyday\n\n\u003csub\u003eFor anyone, any day.\u003c/sub\u003e\n\n- writing-an-email\n- summarizing-a-document\n- planning-a-trip\n- troubleshooting-whats-not-working\n- asking-for-feedback\n\n\u003c/td\u003e\n\u003ctd valign=\"top\" width=\"33%\"\u003e\n\n### 💼 Work\n\n\u003csub\u003eKnowledge-worker essentials.\u003c/sub\u003e\n\n- researching-a-company\n- preparing-for-a-meeting\n- writing-a-status-update\n- responding-to-feedback\n- wrapping-up-a-piece\n- verifying-before-shipping \u003cem\u003e(discipline)\u003c/em\u003e\n\n\u003c/td\u003e\n\u003ctd valign=\"top\" width=\"33%\"\u003e\n\n### 🧠 Thinking\n\n\u003csub\u003eFor making harder calls.\u003c/sub\u003e\n\n- making-a-decision\n- breaking-down-a-problem\n- learning-something-new\n- decisions-need-an-alternative \u003cem\u003e(discipline)\u003c/em\u003e\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd valign=\"top\"\u003e\n\n### 🔬 Research\n\n\u003csub\u003eCitation-rigorous workflows.\u003c/sub\u003e\n\n- literature-scan\n- interview-synthesis\n- structured-literature-review\n- verifying-before-citing \u003cem\u003e(discipline)\u003c/em\u003e\n- researching-five-things-in-parallel \u003cem\u003e(subagent)\u003c/em\u003e\n\n\u003c/td\u003e\n\u003ctd valign=\"top\"\u003e\n\n### ⚙️ Dev\n\n\u003csub\u003eFor shipping software.\u003c/sub\u003e\n\n- brainstorming-a-feature\n- writing-an-implementation-plan\n- executing-a-plan-step-by-step\n\n\u003c/td\u003e\n\u003ctd valign=\"top\"\u003e\n\n### 🔗 Chains\n\n\u003csub\u003eMulti-stage, end-to-end.\u003c/sub\u003e\n\n- general-research-loop\n- dev-tdd-loop\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n**25 hand-crafted spells + 12 framework skills + 12 workflow shapes** — all in [`spells/`](spells/) and [`skills/`](skills/).\n\n---\n\n## Slash commands\n\n| Command | What it does |\n|---|---|\n| `/build-spell` | Interview-driven meta-builder. Routes to the right specialist by `kind`. Now supports `--from-transcript \u003cpath\u003e`. |\n| `/capture-this-chat` | Turn the current chat session into a reusable spell. See [`docs/capturing-chats.md`](docs/capturing-chats.md). |\n| `/cast-spell \u003cname\u003e` | Cast a specific spell on the current task |\n| `/list-spells` | Browse the spellbook. Filters: `--kind`, `--audience`, `--updates` |\n| `/refine-spell \u003cname\u003e` | Update an existing spell (mandatory re-test) |\n| `/share-spell \u003cname\u003e` | Export. Modes: `--strict` (vanilla SKILL.md), `--bundle` (zip) |\n\n---\n\n## Documentation\n\n\u003e **Start here:** [for-non-devs.md](docs/for-non-devs.md) or [for-devs.md](docs/for-devs.md)\n\n| Topic | Doc |\n|---|---|\n| Why behavioral engineering, the 1% rule, the Iron Law | [philosophy.md](docs/philosophy.md) |\n| `kind`, `complexity`, `audience` — picking the right shape | [taxonomy.md](docs/taxonomy.md) |\n| The SKILL.md format spec | [spell-format-spec.md](docs/spell-format-spec.md) |\n| Building blocks: excuses tables, hard gates, warning signs | [skills-primitives.md](docs/skills-primitives.md) |\n| `$WIZARD_HOME` — your personal library | [personal-library.md](docs/personal-library.md) |\n| Semver, update discovery, customization preservation | [versioning-and-updates.md](docs/versioning-and-updates.md) |\n| Three export modes | [sharing-spells.md](docs/sharing-spells.md) |\n| End-to-end walkthroughs (research + dev) | [general-parity-tutorial.md](docs/general-parity-tutorial.md) |\n| V1 release criteria + the self-tests | [definition-of-done.md](docs/definition-of-done.md) |\n\n---\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eProject structure\u003c/b\u003e\u003c/summary\u003e\n\n```\nwizard/\n  README.md                  this file\n  AGENTS.md                  core agent instructions (Codex / OpenCode / Copilot)\n  CLAUDE.md, GEMINI.md       tool-specific entry points\n  CONTRIBUTING.md, LICENSE\n  CHANGELOG.md               release notes\n  package.json               Node project + CLI scripts\n  gemini-extension.json\n  .claude-plugin/            Claude Code plugin descriptor\n  .cursor-plugin/            Cursor plugin descriptor\n  .codex/INSTALL.md\n  .opencode/                 OpenCode plugin (wizard.js)\n  hooks/                     session-start bootstrap\n  scripts/                   validate-spell / new-spell / build-loader / adversarial tests\n  templates/                 SKILL.md templates per kind\n  agents/                    subagent definitions (e.g. spell-tester)\n  commands/                  slash command definitions\n  skills/                    framework skills (meta-builder, validator, inference engine)\n  spells/                    bundled spellbook — everyday / work / thinking / research / dev / chains\n  docs/                      all documentation\n  assets/                    banner + demo SVGs\n```\n\n\u003c/details\u003e\n\n---\n\n## Contributing\n\nPRs welcome — see [CONTRIBUTING.md](CONTRIBUTING.md). The bar for the bundled spellbook is high; for narrower or specialist spells, prefer publishing a community pack ([sharing-spells.md](docs/sharing-spells.md)).\n\nEvery PR runs the validator and the adversarial tests. New spells must include a worked example and a `PASS` tester verdict.\n\n## Privacy\n\nNo telemetry. Ever. Everything runs locally inside your AI tool. Your spells live in `~/.wizard/` on your machine.\n\n## Acknowledgements\n\nInspired by [obra/superpowers](https://github.com/obra/superpowers) by Jesse Vincent — the `SKILL.md` format and the Iron Law come from there.\n\n## Attribution\n\nBuilt and maintained by [RedHunt Labs](https://redhuntlabs.com/) — a CTEM and attack-surface-management team that ships open-source tooling for the security community.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eMade for everyone who'd rather build a tool once than re-prompt forever.\u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredhuntlabs%2Fwizard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fredhuntlabs%2Fwizard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredhuntlabs%2Fwizard/lists"}