Skip to main content
skill CX Codex

discover · zaxbyhub — Claude Code skill for repository discovery

This skill delegates repository discovery and maps project rules, code structure, and risk areas. Use it before a complex change when you need to understand the existing project first.

MIT ★ 539 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ZaxbyHub/opencode-swarm --skill discover -a claude-code
Open on GitHub

What discover does

In DISCOVER mode, the skill sends repository exploration to the active swarm’s explorer agent and waits for its findings. For complex work, it requests a second pass focused on gaps and risks, including hidden requirements, assumptions, scope, and patterns the implementation should follow. The mode is read-only.

After the explorer responds, the skill inspects public API surfaces in key files with symbols; for surveys across several files, it prefers batch_symbols. It checks complexity hotspots and searches for project governance files, then records MUST and SHOULD rules in .swarm/context.md with their source, scope, precedence, and any conflict. Conflicting rules stay separate. The described workflow relies on an active swarm and the symbols, batch_symbols, complexity_hotspots, and glob tools, so missing tools prevent parts of the discovery process.

What it helps with

  • map project rules before changing code
  • inspect public APIs in key files
  • surface hidden requirements and scope risks
  • record conflicting project instructions

Example prompts for the agent

  • Use DISCOVER to inspect this repository and map its rules in .swarm/context.md.
  • For this complex task, look for hidden requirements, scope risks, and existing project patterns.
  • Inspect the key files and flag modules that need a security review or full gates.

How to install discover

1Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill discover -a claude-code

2Manually: put the files in place

~/.claude/skills/discover/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/discover/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about discover

How do I install discover in Claude Code?

Run npx skills add ZaxbyHub/opencode-swarm --skill discover -a claude-code. The skill file is placed at ~/.claude/skills/discover/SKILL.md.

What does the discover skill do?

It delegates repository exploration to an explorer agent, then checks key APIs, complexity hotspots, and project governance files. It records extracted MUST and SHOULD rules in .swarm/context.md, including their sources and conflicts.

What goes into .swarm/context.md?

The skill records mandatory and recommended rules found in project governance files. Each entry carries its source, scope, precedence, and any conflict; conflicting rules are kept distinct.

Source text

SKILL.md · MIT
---
name: discover
description: >
  Full execution protocol for MODE: DISCOVER -- read-only repository discovery and governance/context mapping.
metadata:
  audience: swarm-plugin
---

# Discover Protocol

This protocol is loaded on demand by the architect runtime. The architect prompt keeps only activation, action, and hard safety constraints; the full execution details live here.

### MODE: DISCOVER
Delegate to the active swarm's explorer agent. Wait for response.
For complex tasks, make a second explorer call focused on risk/gap analysis:
- Hidden requirements, unstated assumptions, scope risks
- Existing patterns that the implementation must follow
After explorer returns:
- Run `symbols` tool on key files identified by explorer to understand public API surfaces
- For multi-file module surveys: prefer `batch_symbols` over sequential single-file symbols calls
- Run `complexity_hotspots` if not already run during project discovery (check context.md for existing analysis). Note modules with recommendation "security_review" or "full_gates" in context.md.
- Check for project governance files using the `glob` tool with patterns `project-instructions.md`, `docs/project-instructions.md`, `CONTRIBUTING.md`, `INSTRUCTIONS.md`, `AGENTS.md`, and `CLAUDE.md` (process all matches found). For each file found: read it and extract all MUST (mandatory constraints) and SHOULD (recommended practices) rules. Write the extracted rules to `.swarm/context.md` under a `## Project Governance` section — append if the section exists, create it if not — PRESERVING PROVENANCE for every rule (issue #2131 finding 9): each entry records (a) its source file, (b) the subtree scope the file declares or implies (repo-wide when undeclared), (c) precedence — `AGENTS.md`/`project-instructions.md` outrank `CONTRIBUTING.md`/`INSTRUCTIONS.md`/`CLAUDE.md` when rules conflict, (d) strength (MUST vs SHOULD), and (e) a conflict flag naming the other file whose rule it contradicts, if any. Never flatten conflicting rules into one; surface the conflict. If no MUST or SHOULD rules are found in the file, skip writing. If no governance file is found: skip silently. Existing DISCOVER steps are unchanged.

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

Similar skills

SKILL.md skills catalog →

discover by other authors comes first.

discover Insilico-org The discover Claude Code skill ranks candidate targets for a disease, an aging process, or a drug-repurposing idea. It returns a shortlist with a way to disprove each candidate and an experiment to test it. CX Codex +1 ★ 93repo stars caveman-discover JuliusBrussee caveman-discover is a Claude Code skill that finds LLM workflows in a repository and prepares labels for Caveman Cloud spend. It starts on requests to discover workflows or split spend by job. CX Codex +1 128,300installs discover-analytics-patterns amplitude discover-analytics-patterns finds the analytics call patterns already used in a codebase, from SDK methods to wrappers and imports. Use it before adding new event tracking. CX Codex +1 66,000installs discover-event-surfaces amplitude discover-event-surfaces generates a candidate list of analytics events to instrument by reading a change_brief YAML produced after code diff analysis. CX Codex +1 65,900installs discover-brand official anthropics discover-brand finds brand assets across connected enterprise platforms and builds a structured discovery report. It helps audit style guides and brand voice materials without manual searching. CX Codex +1 3,100installs om-discover open-mercato om-discover runs a product discovery conversation and writes product-brief.md with the problem, evidence, scope and open questions. CX Codex +1 2,500installs earth2studio-discover NVIDIA Earth-2 Team earth2studio-discover finds compatible Earth2Studio models, data sources, and gallery examples for climate workflows. It focuses on discovery, not inference code or data downloads. CX Codex +1 1,900installs

From the same set121

The whole set →
swarm-pr-subscribe swarm-pr-subscribe monitors open pull requests, triages incoming review comments or CI failures, and applies safe fixes until merge. CX Codex +1 ★ 539repo stars swarm-ci-monitor The swarm-ci-monitor skill monitors CI for an approved, reviewed PR, investigates failures, and works through fixes until checks pass. It can then merge the PR after a final review of its state. CX Codex +1 ★ 539repo stars commit-pr commit-pr — a checklist the agent must clear before it commits, pushes or opens a PR. Built for the case where an AI agent publishes the branch, not a person. CX Codex +1 ★ 539repo stars skill-edit-validation skill-edit-validation sweeps test suites for stale assertions after modifying skill markdown files, preventing unexpected CI breaks. CX Codex +1 ★ 539repo stars ci-fix-monitor ci-fix-monitor is a Claude Code skill that monitors pull request check runs and resolves CI failures. It tracks builds until every required job turns green. CX Codex +1 ★ 539repo stars swarm-resume swarm-resume is a Claude Code skill that restores swarm plan state and clears stale git branches to resume work on an approved plan. CX Codex +1 ★ 539repo stars ci-failure-batching ci-failure-batching collects failed PR checks before planning fixes. Use it to group related CI problems and avoid a separate push cycle for each one. CX Codex +1 ★ 539repo stars mock-to-internals-migration mock-to-internals-migration is a Claude Code skill for moving mocks from Vitest to Bun and checking the _internals seam. It activates for mock migrations and related test-structure changes. CX Codex +1 ★ 539repo stars

Project sponsors

Companies that keep this analytics open