kosmos-xray
Specialized tools for analyzing the Kosmos codebase efficiently within limited context windows. Uses AST parsing to extract structural information (classes, methods, signatures) without loading implementation details, achieving ~95% token reduction.
npx skills add majiayu000/claude-skill-registry --skill kosmos-xray --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
--- name: kosmos-xray description: Context-efficient codebase exploration using AST analysis. Use when exploring Kosmos architecture, understanding code structure, or preparing documentation for AI programmers. Triggers: xray, map structure, skeleton, interface, architecture, explore kosmos, warm start, token budget, context compression. --- # Kosmos X-Ray Skill Specialized tools for analyzing the Kosmos codebase efficiently within limited context windows. Uses AST parsing to extract structural information (classes, methods, signatures) without loading implementation details, achieving ~95% token reduction. ## Enhanced Features (v2) The skeleton extractor now captures: - **Pydantic/dataclass fields** - `name: str = Field(...)` visible in output - **Decorators** - `@dataclass`, `@property`, `@tool` shown above definitions - **Global constants** - `CONFIG_VAR = "value"` at module level - **Line numbers** - Every definition includes `# L{line}` for navigation **IMPORTANT**: Always use these features when exploring - they reveal data structures that would otherwise appear as empty `pass` statements. ## When to Use This Skill - **Exploring the codebase** - Map directory structure before
- Enhanced Features (v2)
- When to Use This Skill
- Core Tools
- 1. mapper.py - Directory Structure Map
- 2. skeleton.py - Interface Extraction (Enhanced)
- 3. dependencygraph.py - Import Analysis
- Recommended Workflow (Use ALL Features)
- Best Practices
- DO:
- DON'T:
- Integration with kosmosarchitect Agent
- Configuration Files
- Context Budget Guidelines
Map entire project python .claude/skills/kosmos-xray/scripts/mapper.py Map specific directory python .claude/skills/kosmos-xray/scripts/mapper.py kosmos/workflow/ Get summary only (no tree) - RECOMMENDED FIRST STEP python .claude/skills/kosmos-xray/scripts/mapper.py --summary JSON output for parsing python .claude/skills/kosmos-xray/scripts/mapper.py --json Single file skeleton (includes line numbers by default) python .claude/skills/kosmos-xray/scripts/skeleton.py kosmos/workflow/research_loop.py
What does the kosmos-xray skill do?
Specialized tools for analyzing the Kosmos codebase efficiently within limited context windows. Uses AST parsing to extract structural information (classes, methods, signatures) without loading implementation details, achieving ~95% token reduction.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill kosmos-xray --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.