Analyze an unfamiliar codebase and generate a structured onboarding guide with architecture map, key entry points, conventions, and a starter CLAUDE.md. Use when joining a new project or setting up Claude Code for the first time in a repo.
90
90%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly communicates specific deliverables (onboarding guide, architecture map, CLAUDE.md), uses natural trigger terms a user would employ when joining a new project, and explicitly states when to use it. It occupies a distinct niche that is unlikely to conflict with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'analyze an unfamiliar codebase', 'generate a structured onboarding guide', 'architecture map', 'key entry points', 'conventions', and 'a starter CLAUDE.md'. These are concrete, well-defined outputs. | 3 / 3 |
Completeness | Clearly answers both 'what' (analyze codebase, generate onboarding guide with architecture map, entry points, conventions, CLAUDE.md) and 'when' ('Use when joining a new project or setting up Claude Code for the first time in a repo') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would say: 'unfamiliar codebase', 'onboarding', 'new project', 'architecture map', 'entry points', 'CLAUDE.md', 'joining a new project', 'setting up Claude Code'. These cover the natural ways a user would describe this need. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a clear niche: codebase onboarding and initial CLAUDE.md generation for new projects. The combination of 'unfamiliar codebase', 'onboarding guide', and 'CLAUDE.md' creation is highly distinctive and unlikely to conflict with other skills like general code analysis or documentation generation. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, well-structured skill that provides clear, actionable guidance for codebase onboarding. Its main strength is the concrete reconnaissance checklist and phased workflow with explicit outputs. The primary weakness is length — the inline output templates make the document longer than necessary, and some content is mildly redundant between best practices and anti-patterns sections.
Suggestions
Move the Onboarding Guide and CLAUDE.md output templates to separate reference files (e.g., ONBOARDING_TEMPLATE.md, CLAUDE_TEMPLATE.md) and link to them from the main skill to reduce inline bulk.
Consolidate the 'Best Practices' and 'Anti-Patterns to Avoid' sections into a single 'Guidelines' section to eliminate redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is generally well-structured but includes some unnecessary verbosity. The example tables and directory maps are clearly marked as replaceable examples, which is good, but the overall length (~200 lines) could be tightened. Some sections like 'When to Use' list obvious triggers, and the anti-patterns section partially restates best practices. | 2 / 3 |
Actionability | The skill provides highly concrete, actionable guidance: specific file patterns to detect, exact config filenames to look for, structured output templates with clear markdown formats, and explicit phase-by-phase instructions. The reconnaissance checklist is particularly well-specified with exact glob patterns and filenames. | 3 / 3 |
Workflow Clarity | The 4-phase workflow is clearly sequenced (Reconnaissance → Architecture Mapping → Convention Detection → Generate Artifacts) with each phase building on the previous. Phase 1 explicitly says to run checks in parallel. Best practices include validation guidance ('Verify, don't guess', 'Flag unknowns'). The workflow handles edge cases like shallow git history and existing CLAUDE.md files. | 3 / 3 |
Progressive Disclosure | The content is well-organized with clear headers and phases, but it's a monolithic document that could benefit from splitting the output templates into separate reference files. The inline example output templates for both the Onboarding Guide and CLAUDE.md are quite long and could be referenced externally, keeping the main skill leaner. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
Reviewed
Table of Contents