{"id":"88568311-949d-4972-bb72-a6b524312a29","shortId":"6U9qyS","kind":"skill","title":"using-bundles-forge","tagline":"Use when starting any conversation involving bundle-plugins — blueprinting, scaffolding, authoring, auditing, testing, optimizing, or releasing. Also use when feeling unsure which bundles-forge skill applies","description":"<SUBAGENT-STOP>\nIf you were dispatched as a subagent to execute a specific task, skip this skill.\n</SUBAGENT-STOP>\n\n## Pre-flight Check\n\nBefore invoking any bundles-forge skill on a target directory, verify the target is a bundle-plugin project:\n- Does it have a `skills/` directory?\n- Does it have a `package.json`?\n\nIf neither exists, inform the user: \"This directory doesn't appear to be a bundle-plugin project. Bundles Forge skills are designed for bundle-plugins (repositories where skills are the primary content). Would you like to create a new bundle-plugin here, or did you mean to point to a different directory?\"\n\nException: `bundles-forge:auditing` and `bundles-forge:optimizing` can also operate on individual skill folders or files — they don't require a full bundle-plugin project.\n\n## Instruction Priority\n\n1. **User's explicit instructions** (CLAUDE.md, GEMINI.md, AGENTS.md, direct requests) — highest priority\n2. **Bundles Forge skills** — override default system behavior where they conflict\n3. **Default system prompt** — lowest priority\n\n## How to Access Skills\n\n**In Claude Code:** Use the `Skill` tool. When you invoke a skill, its content is loaded — follow it directly.\n\n**In Cursor:** Use the `Skill` tool.\n\n**In Gemini CLI:** Skills activate via the `activate_skill` tool. See `references/gemini-tools.md` for tool mapping.\n\n**In Codex:** Skills are discovered from `~/.agents/skills/`. See `references/codex-tools.md` for tool mapping.\n\n**In OpenClaw:** Skills auto-load from the bundle's `skills/` directory. See `references/openclaw-tools.md` for tool mapping.\n\n## Platform Adaptation\n\nSkills use Claude Code tool names as the default. Non-Claude-Code platforms: see the tool mapping references in this directory for equivalents.\n\n## The Rule\n\n**Invoke relevant skills BEFORE any response or action** when working with bundle-plugins. If there's even a small chance a skill applies, invoke it to check.\n\n```\nUser message about bundle-plugins\n  → Might any skill apply?\n    → yes → Invoke Skill tool → Follow skill → Respond\n    → no  → Respond directly\n```\n\n## Orchestrators (high-frequency entry points)\n\nThese skills diagnose, decide, and delegate. They orchestrate other skills to accomplish multi-step goals.\n\n| Skill | Role | When to Use |\n|-------|------|-------------|\n| `bundles-forge:blueprinting` | New-project orchestrator | Planning new bundle-plugins, splitting complex skills, or composing skills into bundles. Orchestrates the full creation pipeline: scaffolding → authoring → workflow design → auditing |\n| `bundles-forge:optimizing` | Improvement orchestrator | Engineering optimization, feedback iteration, descriptions, tokens, adding skills, restructuring workflows. Delegates content changes to authoring |\n| `bundles-forge:releasing` | Release pipeline orchestrator | Version management, release pipeline: audit, test, version bump, publish |\n\n## Executors (single-responsibility workers)\n\nThese skills do one thing well. They can be invoked directly by users or dispatched by orchestrators.\n\n| Skill | Role | When to Use |\n|-------|------|-------------|\n| `bundles-forge:scaffolding` | Structure generator | Generating project structure, adding or removing platform support |\n| `bundles-forge:authoring` | Content writer | Writing or improving SKILL.md content and agent definitions (agents/*.md) |\n| `bundles-forge:auditing` | Diagnostic reporter | Reviewing a project for quality issues, security risks — outputs reports, does not orchestrate fixes |\n| `bundles-forge:testing` | Dynamic verifier | Testing a plugin locally — dev-marketplace setup, hook smoke tests, component discovery, cross-platform readiness |\n\n## Meta-skill\n\n| Skill | Purpose |\n|-------|---------|\n| `bundles-forge:using-bundles-forge` | Bootstrap meta-skill — you're reading it now (auto-loaded by hooks) |\n\n## Skill Priority\n\nWhen multiple skills could apply, prefer orchestrators over executors:\n\n1. **New project** → `bundles-forge:blueprinting` (orchestrates scaffolding, authoring, auditing)\n2. **Improve existing project** → `bundles-forge:optimizing` (orchestrates authoring, scaffolding, auditing)\n3. **Release** → `bundles-forge:releasing` (orchestrates auditing, testing, optimizing)\n4. **Standalone content writing** → `bundles-forge:authoring` (when you just need to write/improve a SKILL.md)\n5. **Standalone structure** → `bundles-forge:scaffolding` (when you just need to add/remove a platform)\n6. **Standalone audit** → `bundles-forge:auditing` (when you just need a diagnostic report)\n7. **Standalone testing** → `bundles-forge:testing` (when you just need to verify a plugin works locally)\n\n## Naming Conventions\n\n- **Project name**: kebab-case, descriptive (`dev-workflows`, `data-tools`)\n- **Skill directories**: kebab-case matching the `name` frontmatter field\n- **Cross-references**: `<project>:<skill-name>`\n- **Bootstrap skill**: `using-<project>`\n- **Agent prompts**: `agents/<role>.md`\n\n## Skill Types\n\n- **Rigid skills** (discipline-enforcing) — follow exactly, no adaptation. Examples: TDD, verification.\n- **Flexible skills** (pattern-based) — adapt principles to context. Examples: brainstorming, optimization.\n\nThe skill itself declares which type it is.\n\n## Inputs\n\n- (none — bootstrap skill, loaded on demand via Skill tool)\n\n## Outputs\n\n- `routing-context` — skill routing table, platform adaptation guidance, and instruction priority for the current session","tags":["using","bundles","forge","odradekai","agent-skills","bundle-plugin","claude-code","claude-plugin","claude-skills","cursor-plugin"],"capabilities":["skill","source-odradekai","skill-using-bundles-forge","topic-agent-skills","topic-bundle-plugin","topic-claude-code","topic-claude-plugin","topic-claude-skills","topic-cursor-plugin"],"categories":["bundles-forge"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/OdradekAI/bundles-forge/using-bundles-forge","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add OdradekAI/bundles-forge","source_repo":"https://github.com/OdradekAI/bundles-forge","install_from":"skills.sh"}},"qualityScore":"0.554","qualityRationale":"deterministic score 0.55 from registry signals: · indexed on github topic:agent-skills · 208 github stars · SKILL.md body (5,421 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T12:54:06.108Z","embedding":null,"createdAt":"2026-04-18T22:12:15.727Z","updatedAt":"2026-05-02T12:54:06.108Z","lastSeenAt":"2026-05-02T12:54:06.108Z","tsv":"'/.agents/skills':248 '1':169,579 '2':181,590 '3':192,602 '4':612 '5':628 '6':643 '7':657 'access':200 'accomplish':364 'action':306 'activ':231,234 'ad':417,478 'adapt':272,718,727,760 'add/remove':640 'agent':495,497,704,706 'agents.md':176 'also':22,149 'appear':93 'appli':32,322,336,574 'audit':17,142,404,437,502,589,601,609,645,649 'author':16,401,425,486,588,599,619 'auto':258,564 'auto-load':257,563 'base':726 'behavior':188 'blueprint':14,377,585 'bootstrap':554,701,744 'brainstorm':732 'bump':440 'bundl':3,12,29,56,69,98,101,108,125,140,145,164,182,262,311,331,375,385,394,406,427,470,484,500,520,548,552,583,595,605,617,632,647,661 'bundle-plugin':11,68,97,107,124,163,310,330,384 'bundles-forg':28,55,139,144,374,405,426,469,483,499,519,547,582,594,604,616,631,646,660 'case':680,692 'chanc':319 'chang':423 'check':51,326 'claud':203,275,284 'claude.md':174 'cli':229 'code':204,276,285 'codex':243 'complex':388 'compon':536 'compos':391 'conflict':191 'content':116,215,422,487,493,614 'context':730,755 'convent':675 'convers':9 'could':573 'creat':121 'creation':398 'cross':539,699 'cross-platform':538 'cross-refer':698 'current':767 'cursor':222 'data':686 'data-tool':685 'decid':356 'declar':737 'default':186,193,281 'definit':496 'deleg':358,421 'demand':748 'descript':415,681 'design':105,403 'dev':530,683 'dev-marketplac':529 'dev-workflow':682 'diagnos':355 'diagnost':503,655 'differ':136 'direct':177,220,346,457 'directori':62,77,90,137,265,294,689 'disciplin':713 'discipline-enforc':712 'discov':246 'discoveri':537 'dispatch':36,461 'doesn':91 'dynam':523 'enforc':714 'engin':411 'entri':351 'equival':296 'even':316 'exact':716 'exampl':719,731 'except':138 'execut':41 'executor':442,578 'exist':85,592 'explicit':172 'feedback':413 'feel':25 'field':697 'file':156 'fix':518 'flexibl':722 'flight':50 'folder':154 'follow':218,341,715 'forg':4,30,57,102,141,146,183,376,407,428,471,485,501,521,549,553,584,596,606,618,633,648,662 'frequenc':350 'frontmatt':696 'full':162,397 'gemini':228 'gemini.md':175 'generat':474,475 'goal':368 'guidanc':761 'high':349 'high-frequ':348 'highest':179 'hook':533,567 'improv':409,491,591 'individu':152 'inform':86 'input':742 'instruct':167,173,763 'invok':53,211,299,323,338,456 'involv':10 'issu':510 'iter':414 'kebab':679,691 'kebab-cas':678,690 'like':119 'load':217,259,565,746 'local':528,673 'lowest':196 'manag':434 'map':241,253,270,290 'marketplac':531 'match':693 'md':498,707 'mean':131 'messag':328 'meta':543,556 'meta-skil':542,555 'might':333 'multi':366 'multi-step':365 'multipl':571 'name':278,674,677,695 'need':623,638,653,667 'neither':84 'new':123,379,383,580 'new-project':378 'non':283 'non-claude-cod':282 'none':743 'one':450 'openclaw':255 'oper':150 'optim':19,147,408,412,597,611,733 'orchestr':347,360,381,395,410,432,463,517,576,586,598,608 'output':513,752 'overrid':185 'package.json':82 'pattern':725 'pattern-bas':724 'pipelin':399,431,436 'plan':382 'platform':271,286,481,540,642,759 'plugin':13,70,99,109,126,165,312,332,386,527,671 'point':133,352 'pre':49 'pre-flight':48 'prefer':575 'primari':115 'principl':728 'prioriti':168,180,197,569,764 'project':71,100,166,380,476,507,581,593,676 'prompt':195,705 'publish':441 'purpos':546 'qualiti':509 're':559 'read':560 'readi':541 'refer':291,700 'references/codex-tools.md':250 'references/gemini-tools.md':238 'references/openclaw-tools.md':267 'releas':21,429,430,435,603,607 'relev':300 'remov':480 'report':504,514,656 'repositori':110 'request':178 'requir':160 'respond':343,345 'respons':304,445 'restructur':419 'review':505 'rigid':710 'risk':512 'role':370,465 'rout':754,757 'routing-context':753 'rule':298 'scaffold':15,400,472,587,600,634 'secur':511 'see':237,249,266,287 'session':768 'setup':532 'singl':444 'single-respons':443 'skill':31,47,58,76,103,112,153,184,201,207,213,225,230,235,244,256,264,273,301,321,335,339,342,354,362,369,389,392,418,448,464,544,545,557,568,572,688,702,708,711,723,735,745,750,756 'skill-using-bundles-forge' 'skill.md':492,627 'skip':45 'small':318 'smoke':534 'source-odradekai' 'specif':43 'split':387 'standalon':613,629,644,658 'start':7 'step':367 'structur':473,477,630 'subag':39 'support':482 'system':187,194 'tabl':758 'target':61,65 'task':44 'tdd':720 'test':18,438,522,525,535,610,659,663 'thing':451 'token':416 'tool':208,226,236,240,252,269,277,289,340,687,751 'topic-agent-skills' 'topic-bundle-plugin' 'topic-claude-code' 'topic-claude-plugin' 'topic-claude-skills' 'topic-cursor-plugin' 'type':709,739 'unsur':26 'use':2,5,23,205,223,274,373,468,551,703 'user':88,170,327,459 'using-bundles-forg':1,550 'verif':721 'verifi':63,524,669 'version':433,439 'via':232,749 'well':452 'work':308,672 'worker':446 'workflow':402,420,684 'would':117 'write':489,615 'write/improve':625 'writer':488 'yes':337","prices":[{"id":"0eb24ca0-50df-4cd6-b1ed-dc596e524c28","listingId":"88568311-949d-4972-bb72-a6b524312a29","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"OdradekAI","category":"bundles-forge","install_from":"skills.sh"},"createdAt":"2026-04-18T22:12:15.727Z"}],"sources":[{"listingId":"88568311-949d-4972-bb72-a6b524312a29","source":"github","sourceId":"OdradekAI/bundles-forge/using-bundles-forge","sourceUrl":"https://github.com/OdradekAI/bundles-forge/tree/main/skills/using-bundles-forge","isPrimary":false,"firstSeenAt":"2026-04-18T22:12:15.727Z","lastSeenAt":"2026-05-02T12:54:06.108Z"}],"details":{"listingId":"88568311-949d-4972-bb72-a6b524312a29","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"OdradekAI","slug":"using-bundles-forge","github":{"repo":"OdradekAI/bundles-forge","stars":208,"topics":["agent-skills","bundle-plugin","claude-code","claude-plugin","claude-skills","cursor-plugin"],"license":"apache-2.0","html_url":"https://github.com/OdradekAI/bundles-forge","pushed_at":"2026-04-27T02:13:58Z","description":"An agentic skills framework & bundle-plugin engineering toolkit that works.","skill_md_sha":"2f00dac3b7b1d509553c8b1672e1a5b9dec3d5c0","skill_md_path":"skills/using-bundles-forge/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/OdradekAI/bundles-forge/tree/main/skills/using-bundles-forge"},"layout":"multi","source":"github","category":"bundles-forge","frontmatter":{"name":"using-bundles-forge","description":"Use when starting any conversation involving bundle-plugins — blueprinting, scaffolding, authoring, auditing, testing, optimizing, or releasing. Also use when feeling unsure which bundles-forge skill applies"},"skills_sh_url":"https://skills.sh/OdradekAI/bundles-forge/using-bundles-forge"},"updatedAt":"2026-05-02T12:54:06.108Z"}}