{
  "markdown": "# Yellowpages\n\nYellowpages is a progressive-disclosure skill library for AI agents. It keeps runtime context small by injecting one bootstrap skill, then loading category routers, leaf skills, and reference files only when the current request needs them.\n\nThe old `yp-stack` npm installer has been removed. Yellowpages now installs through each host's native plugin, extension, or skill-discovery mechanism.\n\n## Runtime Model\n\nAt session start, the host injects only:\n\n```text\nskills/yellowpages/using-yellowpages/SKILL.md\n```\n\nThat bootstrap teaches the agent this routing ladder:\n\n```text\nusing-yellowpages -> category router -> leaf skill -> reference file\n```\n\nThe important rule is: load one step at a time and stop as soon as there is enough context to act.\n\n## Category Routers\n\n| Router | Use for |\n|---|---|\n| `yp-workflow` | Normal coding-session work: frame, design, plan, execute, verify, review |\n| `yp-skill-system` | Yellowpages itself: authoring, validation, diagnostics, skill management |\n| `yp-stack-router` | Stack/domain guidance: Convex, React, UI, monorepos, preferred tooling |\n| `yp-session-tools` | Help, status, injected context, notes, reloads, compression |\n\n`yp-workflow` is the default for normal software-engineering requests. `yp-stack-router` is opt-in for stack, framework, architecture, or tooling questions.\n\n## Workflow Model\n\nThe software-building workflow is now a tiny default core with optional capabilities:\n\n```text\nusing-yellowpages -> yp-workflow -> core stage -> optional capability -> reference\n```\n\n### Core stages\n\n| Stage | Skill | Purpose |\n|---|---|---|\n| Frame | `yp-workflow-frame` | clarify the request, assumptions, and success criteria |\n| Design | `yp-workflow-design` | compare approaches and define the simplest sufficient design |\n| Plan | `yp-workflow-plan` | turn approved scope into an implementation plan |\n| Execute | `yp-workflow-execute` | perform the work with minimal, surgical changes |\n| Verify | `yp-workflow-verify` | require fresh evidence before completion claims |\n| Review | `yp-workflow-review` | inspect correctness, readiness, and review feedback |\n\n### Optional workflow capabilities\n\nThese are loaded only when useful, not by default:\n\n- `yp-workflow-subagents`\n- `yp-workflow-parallel-agents`\n- `yp-workflow-git-worktrees`\n- `yp-workflow-tdd`\n- `yp-workflow-debugging`\n- `yp-workflow-review-loops`\n- `yp-workflow-handoffs`\n\nLegacy workflow skills remain for compatibility during the transition:\n`yp-brainstorm`, `yp-auto-plan`, `yp-tasks`, `yp-verify`, `pr-code-review`.\n\n## Install\n\n### Claude Code\n\nInstall from a Claude plugin marketplace that points at this repo, or register this repo as a development marketplace:\n\n```bash\n/plugin marketplace add nilsclabb/yellowpages\n/plugin install yellowpages@yellowpages-dev\n```\n\nClaude plugin metadata lives in `.claude-plugin/`. SessionStart bootstrap hooks live in `hooks/`.\n\n### Cursor\n\nInstall through Cursor's plugin system from this repository. The Cursor plugin manifest is `.cursor-plugin/plugin.json`.\n\nThe plugin exposes:\n\n- `skills/yellowpages/` as the skill library\n- `.agents/agents/` as agent definitions\n- `commands/` as high-level chat command aliases\n- `hooks/hooks-cursor.json` for bootstrap injection\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/nilsclabb/yellowpages\n```\n\nGemini loads `GEMINI.md`, which imports the `using-yellowpages` bootstrap.\n\n### OpenCode\n\nAdd yellowpages to `opencode.json`:\n\n```json\n{\n  \"plugin\": [\"yellowpages@git+https://github.com/nilsclabb/yellowpages.git\"]\n}\n```\n\nSee `.opencode/INSTALL.md`.\n\n### Codex\n\nCodex uses native discovery from `~/.agents/skills/`:\n\n```bash\ngit clone https://github.com/nilsclabb/yellowpages.git ~/.codex/yellowpages\nmkdir -p ~/.agents/skills\nln -s ~/.codex/yellowpages/skills/yellowpages ~/.agents/skills/yellowpages\n```\n\nSee `.codex/INSTALL.md`.\n\n## Repo Layout\n\n```text\nskills/yellowpages/       installable skills, single source of truth\n  using-yellowpages/      bootstrap skill injected at session start\n  yp-workflow/            coding-session workflow router\n  yp-skill-system/        yellowpages/skill maintenance router\n  yp-stack-router/        stack and domain router\n  yp-session-tools/       session/context utility router\n  SKILL.md                yellowpages authoring standard\n  INDEX.md                audit/discovery index\n  references/             core reference files\n  scripts/                validation and utility scripts\n  yp-workflow-*/          workflow core + optional capability leaf skills\n  <skill-name>/           other leaf skills\n\n.agents/                 governance: agents, workflows, checklists, templates, state\n.claude-plugin/          Claude plugin metadata\n.cursor-plugin/          Cursor plugin metadata\n.opencode/               OpenCode plugin entrypoint and install docs\n.codex/                  Codex install docs\ncommands/                high-level chat command aliases\nhooks/                   native SessionStart bootstrap hooks\n```\n\nAll installable skills live in `skills/yellowpages/`. Do not duplicate skills into `.agents/`.\n\n## Commands\n\nCommands are not the skill registry. They are optional intent shortcuts:\n\n| Command | Meaning |\n|---|---|\n| `/yellowpages` | Route the current request through Yellowpages |\n| `/yp` | Alias for `/yellowpages` |\n\nLeaf skills load through native skill tooling, not one-command-per-skill mirrors.\n\n## Skill Design Rules\n\n| Rule | Meaning |\n|---|---|\n| Cover-page brevity | `SKILL.md` stays at or under 80 lines |\n| One job per file | A file routes or explains, never both |\n| Load on demand | Read only the branch required by the task |\n| Deep-link navigation | Every reference states when to read it |\n| Flat skill namespace | Skills are sibling folders under `skills/yellowpages/` |\n\n## Development\n\nValidate all skills:\n\n```bash\npython3 skills/yellowpages/scripts/quick_validate.py --all skills/yellowpages\n```\n\nExpected result for the current tree:\n\n```text\nResults: 44 passed, 0 failed, 44 total\n```\n\nValidate native manifests and hooks:\n\n```bash\nnode -e \"const fs=require('fs'); for (const f of ['.claude-plugin/plugin.json','.claude-plugin/marketplace.json','.cursor-plugin/plugin.json','gemini-extension.json','package.json','hooks/hooks.json','hooks/hooks-cursor.json']) JSON.parse(fs.readFileSync(f,'utf8')); console.log('json ok')\"\nbash -n hooks/session-start && bash -n hooks/run-hook.cmd\n```\n\nBehavioral tests should verify that natural prompts trigger the right category router first, then the correct leaf skill.\n\n## Contributing\n\nRead `CONTRIBUTING.md` before opening a PR.\n\n## License\n\nMIT\n",
  "bytes": 6624,
  "sha": "8576081d7cf3663bb80a3cb54c5e22d6ec8760a394ed2b825cde4e2301889f84",
  "repo_slug": "nilsclabb/yellowpages",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_nilsclabb_yellowpages_a67cebd1/readme"
}