ai-badger-contribution

Guides contributing stacks, agents, skills, and hooks to the ai-badger framework with TDD and CI checks.

2|Updated Aug 2, 2026
One-click install
npx skills add https://github.com/Arasz/ai-raccoon --skill ai-badger-contribution-arasz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-badger-contribution
Source: https://github.com/Arasz/ai-raccoon/tree/main/.ai-badger/skills/learned/uncategorized/ai-badger-contribution
Command: npx skills add https://github.com/Arasz/ai-raccoon --skill ai-badger-contribution-arasz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Contributing to the ai-badger framework requires knowing its stack × feature catalog layout, worktree isolation rules, TDD test patterns, and a strict sequence of CI checks (pylint, index rebuild, version sync, schema validation, release guard). This Skill encodes that entire contribution workflow so changes pass CI on the first push instead of failing on stale indexes, unsynced plugin copies, or schema drift. ## Core Features & Use Cases - Catalog feature authoring: Step-by-step procedures for adding new agents (data-only via scaffolding.json), stacks, operational skills, hooks, and MCP server declarations under features/{stack}/{feature}/. - TDD and mock-framework test patterns: Reusable fixtures for building minimal mock framework trees, writing discriminating tests, and avoiding pitfalls like IsADirectoryError on templates or stale sys.modules caches. - CI gate checklist: Ordered commands for pylint, index_build.py --check, version_sync.py, changelog index, schema validation, release guard, and pytest, plus a reviewer quality gate for finished branches. - Use Case: When adding a new operational skill to ai-badger, follow the Skill to write the ADR, create tests first, implement the script with _bootstrap_lib(), author SKILL.md, rebuild the index, sync plugin copies, and run the full CI sequence before pushing. ## Quick Start Ask the agent to add a new operational skill to the ai-badger framework following the contribution workflow, starting with an ADR and failing tests.

Frequently Asked Questions about ai-badger-contribution

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new operational skill to ai-badger?

Write an ADR, create failing tests first using the mock framework pattern, implement the script under features/common/skills/<name>/scripts/ with _bootstrap_lib(), author SKILL.md with trigger phrases, then run index_build.py to wire it into the catalog.

How do I add a new agent to ai-badger without changing scaffold.py?

Create features/<agent>/ with stack.json, scaffolding.json, and symlinked templates, add the agent name to the config and manifest schema enums, add detection logic in detect.py, and rebuild the index. Adding an agent is a data-only change.

Why does ai-badger CI fail with index.json is missing or stale?

The index.json is script-generated by index_build.py and goes stale after any catalog change such as adding features or moving directories. Run python3 tooling/index_build.py after every catalog change and verify with the --check flag before pushing.

Why does pylint fail on import badger_lib in ai-badger scripts?

Pylint cannot see the runtime sys.path modification from _bootstrap_lib(), so it reports E0401 on the import. Add a pylint disable comment for wrong-import-position on the import line, and ensure pylint is installed in the system Python for the pre-commit hook.

When must I bump VERSION in the ai-badger repo?

Bump VERSION whenever you add files under shipped surfaces such as skills/, features/, schemas/, or index.json, because release_guard.py compares against the last release tag. After bumping, also run version_sync.py to update plugin.json and marketplace.json.

What are the limitations of den-refresh for picking up new framework features?

den-refresh only re-scaffolds when drift is detected on existing manifest entries, so newly added catalog items are invisible to it. To pick up a new agent, stack, or skill, add it to config.json and re-run welcome-ai-badger's scaffold.py instead.