MUST run before any code implementation task. Classifies complexity, discovers local conventions, finds reusable patterns, and prevents blind coding. Invoke this skill before writing or modifying code.
52
57%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.codex/skills/context-hunter/SKILL.mdQuality
Discovery
52%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description has a clear 'when' clause which is a strength, explicitly stating it should run before code implementation. However, it suffers from a lack of natural trigger terms that users would actually say, and the capability descriptions are somewhat abstract rather than concrete. The skill's purpose as a pre-coding analysis step is identifiable but could conflict with other code analysis or planning skills.
Suggestions
Add natural trigger terms users would say, such as 'plan implementation', 'analyze codebase', 'understand existing code', 'code planning', or 'before I start coding'.
Make capabilities more concrete — e.g., instead of 'classifies complexity' say 'estimates task complexity (small/medium/large)', and instead of 'discovers local conventions' say 'identifies naming conventions, file structure patterns, and coding style from existing code'.
Clarify distinctiveness by specifying what kind of analysis this performs versus other code analysis skills (e.g., 'pre-implementation reconnaissance of the codebase' vs. code review or debugging).
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names some actions like 'classifies complexity', 'discovers local conventions', 'finds reusable patterns', and 'prevents blind coding', but these are somewhat abstract and not fully concrete — e.g., 'prevents blind coding' is vague and 'classifies complexity' lacks detail on what is classified or how. | 2 / 3 |
Completeness | The description answers both 'what' (classifies complexity, discovers conventions, finds reusable patterns) and 'when' ('MUST run before any code implementation task', 'Invoke this skill before writing or modifying code'), with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | The description lacks natural keywords a user would say. Terms like 'classifies complexity', 'discovers local conventions', and 'prevents blind coding' are not phrases users would naturally use. Missing terms like 'plan', 'analyze codebase', 'code review', 'understand code', or 'before coding'. | 1 / 3 |
Distinctiveness Conflict Risk | The pre-implementation analysis niche is somewhat distinct, but phrases like 'code implementation task' and 'writing or modifying code' are extremely broad and could overlap with many coding-related skills. The description doesn't clearly carve out a unique niche beyond being a pre-step. | 2 / 3 |
Total | 8 / 12 Passed |
Implementation
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured process skill with strong workflow clarity and a thoughtful complexity-gating mechanism. Its main weaknesses are the lack of concrete, executable examples (no actual commands or code snippets for discovery actions) and some verbosity that could be trimmed. The hardcoded reference to 'Nuxt + Vue + Tailwind 4.1' reduces portability.
Suggestions
Add concrete, executable examples for discovery actions—e.g., specific grep/ripgrep commands, git log invocations, or file listing patterns that Claude can directly use.
Provide a template/example for the micro-brief and full context brief outputs so Claude knows the exact expected format.
Remove or parameterize the hardcoded 'Nuxt + Vue + Tailwind 4.1' reference to make the skill portable across projects.
Consider extracting the detailed L2 checklist and naming derivation rules into a separate reference file to keep the main SKILL.md leaner.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient and assumes Claude's competence, but some sections are slightly verbose—e.g., the 'Core Behavior' metaphor ('Act like a senior engineer') and some of the discovery examples could be tightened. The 'Existing design system choices (for this repo: Nuxt + Vue + Tailwind 4.1 patterns)' is oddly specific and hardcoded. Overall mostly lean but not maximally tight. | 2 / 3 |
Actionability | Provides structured guidance with clear steps and checklists, but lacks concrete executable examples—no actual commands, code snippets, or specific tool invocations. Discovery actions like 'Search for feature/domain terms' and 'Inspect recent change history' are directional but not copy-paste ready (e.g., no specific grep/git commands). The output format for briefs is described but not templated. | 2 / 3 |
Workflow Clarity | Excellent multi-step workflow with clear sequencing (classify → discover → synthesize → implement → verify). Includes explicit validation checkpoints (confidence-based stop rule, verification after coding), feedback loops (re-evaluate level during discovery, upgrade if needed), and scaled outputs by complexity level. The checklist at the end serves as a final validation gate. | 3 / 3 |
Progressive Disclosure | Well-organized with clear section headers and logical progression from classification to discovery to implementation to verification. However, as a standalone file with no bundle, some sections (like the full L2 brief format, naming derivation examples, or discovery action specifics) could benefit from being split into referenced files. The content is moderately long but not monolithic—it's all inline with no external references. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
7910582
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.