bubbles-skills-first-discovery

Maps agent task situations to the correct Bubbles governance skill module.

1|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/pkirsanov/bubbles --skill bubbles-skills-first-discovery-pkirsanov
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bubbles-skills-first-discovery
Source: https://github.com/pkirsanov/bubbles/tree/main/skills/bubbles-skills-first-discovery
Command: npx skills add https://github.com/pkirsanov/bubbles --skill bubbles-skills-first-discovery-pkirsanov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents working in the Bubbles framework often do not know which governance policy module applies to their current task, leading to eager-loading of 14k+ lines of shared policy or missed enforcement rules. This Skill routes any situation to the right policy skill on demand. ## Core Features & Use Cases - Situation-to-Skill Mapping: A lookup table maps common agent actions (marking DoD items, citing paths, transitioning status, writing tests) to the correct Bubbles skill such as bubbles-anti-fabrication or bubbles-claim-grounding. - Lazy Policy Loading: Replaces bulk-loading of agents/bubbles_shared/*.md with on-demand skill loading driven by what the agent is about to do. - Governance Routing: Points agents to the authoritative modules, enforcement scripts, and workflow configuration where the actual enforceable rules live. - Use Case: An agent about to mark a Definition-of-Done item complete consults this Skill, is routed to bubbles-anti-fabrication and bubbles-evidence-capture, and loads only those policies instead of the entire shared module set. ## Quick Start Ask which Bubbles policy skill applies before starting your current task, then load the mapped skill it returns.

Frequently Asked Questions about bubbles-skills-first-discovery

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

FAQPage Schema
How do I find which Bubbles policy skill applies to my task?▼

Consult the situation-to-skill mapping table in this Skill. Match what you are about to do, such as marking a DoD item or writing tests, to the listed skill, then load that skill for the applicable policy.

What is skills-first loading in the Bubbles framework?▼

Skills-first loading replaces eager-loading of all agents/bubbles_shared/*.md policy files with on-demand skill loading. A skill enters context only when its description matches the current work, avoiding 14k+ lines of policy in every agent prompt.

Where do the authoritative Bubbles governance rules live?▼

The enforceable rules live in agents/bubbles_shared/*.md modules, bubbles/scripts/*.sh enforcement scripts, bubbles/workflows.yaml, and bubbles/capability-ledger.yaml. Skills are discovery shims that route to these modules, not replacements for them.

Does skills-first loading change how done specs are audited?▼

No. The grandfather clause is preserved: historical done specs are not re-evaluated under new skill-derived policy unless their state.json is touched in the same commit. The default advisory profile of done-spec-audit.sh keeps this intact.

When should I not use this discovery skill?▼

Skip it when you already know which governance module applies to your task and can load that skill directly. It is intended for uncertain situations, unnamed policy questions, and agent onboarding, not as a mandatory step for every action.