cs-explore

Documents targeted codebase exploration into searchable evidence-backed markdown records.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/wildlily1021/XW_Software --skill cs-explore-wildlily1021
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cs-explore
Source: https://github.com/wildlily1021/XW_Software/tree/main/.agents/skills/cs-explore
Command: npx skills add https://github.com/wildlily1021/XW_Software --skill cs-explore-wildlily1021

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When developers investigate how a repository works, their findings usually vanish after the conversation ends, forcing the same code-reading effort to be repeated later. This Skill turns the "ask question → read code → reach conclusion" loop into archived, searchable exploration documents with file:line evidence. ## Core Features & Use Cases - Three exploration types: question (answer a specific code question), module-overview (map a module's structure, entry points, and dependencies), and spike (lightweight probing of multiple technical directions without deciding). - Evidence-first documentation: every conclusion must trace back to 3-8 pieces of evidence annotated with file:line, with a conclusion-first quick-answer section and Mermaid diagrams for multi-module flows. - Lifecycle management: detects overlapping prior explorations, supports updating, superseding, and marking outdated documents, and archives results to codestable/compound/ with searchable YAML frontmatter. - Use Case: A new team member asks "how does the serial data parsing work in this repo?" The Skill reads the actual code, produces a dated explore document with a quick answer, cited evidence, and a Mermaid call-chain diagram, then archives it so the next person finds it in seconds. ## Quick Start Ask the AI to explore how a specific feature is implemented in this repository and archive the findings as an explore document.

Frequently Asked Questions about cs-explore

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

FAQPage Schema
How do I document codebase exploration findings for my team?▼

Run a targeted exploration that reads the actual code, then archive the result as a markdown document with a conclusion-first quick answer, 3-8 evidence items citing file:line, and YAML frontmatter. Documents are stored in codestable/compound/ and searchable by keyword or type.

What is the difference between question, module-overview, and spike exploration?▼

Question type answers one specific code question with a conclusion. Module-overview maps a module's structure, entry points, and dependencies. Spike lightly probes multiple technical directions without making a final decision.

How do I search previous code exploration documents?▼

Use the search-yaml.py tool with filters on the compound directory, for example filtering by doc_type=explore, type, or status, plus a keyword query. Results can be returned as JSON for further processing.

What happens when an old exploration document becomes outdated?▼

When code changes invalidate old conclusions, the old document is marked status: outdated with a superseded-by pointer, and a new exploration document is created. If only evidence needs supplementing, the original file is updated in place with an updated date.

When should I not use codebase exploration documentation?▼

Do not use it when you already need a design decision, a fix prescription, or direct bug repair. Exploration only records what was observed in the code; decision-making and fixing belong to separate downstream workflows.