Bootstrap project context from .context/session/in/ with manifest-driven organisation and token-aware file sizing.
82
82%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
89%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 well-crafted description that clearly communicates its purpose, timing, and trigger conditions. It excels at distinctiveness due to specific folder paths and workflow constraints. The only minor weakness is that the specificity of concrete actions could be slightly more detailed (e.g., what manifest-driven organization entails or what the snapshot contains).
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (context bootstrapping) and describes the core action (create baseline context from a specific folder with manifest-driven organization), but doesn't list multiple concrete sub-actions beyond the single high-level task. | 2 / 3 |
Completeness | Clearly answers both 'what' (create baseline context from .context/session/in/ folder with manifest-driven organization) and 'when' (bootstrapping project context, setting up snapshot) with explicit trigger terms listed. | 3 / 3 |
Trigger Term Quality | Includes explicit trigger phrases ('create context', 'bootstrap context', 'setup context', 'init context') that are natural terms a user would say, plus mentions specific paths like '.context/session/in/' and '.context/session/ctx/' which aid precise matching. | 3 / 3 |
Distinctiveness Conflict Risk | Highly specific to a particular workflow involving .context/session/ folder structure and manifest-driven organization; the combination of specific paths and 'run once per project' constraint makes it very unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
70%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 skill with a clear multi-step workflow and good progressive disclosure to reference.md. Its main weaknesses are verbosity in the 'When to Use', 'When Not to Use', and 'Anti-Patterns' sections which could be significantly condensed, and incomplete actionability since critical details like the manifest schema and baseline template are deferred to an external file without inline examples.
Suggestions
Condense 'When to Use' and 'When Not to Use' into a compact table or short bullet list — the current 5-bullet explanations are overly detailed for guidance Claude can infer.
Trim 'Anti-Patterns' to just the rule and a one-line reason, removing the bold 'Why:' elaborations that restate obvious consequences.
Include a minimal inline example of the manifest.yaml structure (even 5-10 lines) so the skill is actionable without requiring reference.md for the core workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient but includes sections that could be tightened. The 'When to Use', 'When Not to Use', and 'Anti-Patterns' sections are verbose with explanations that repeat information already conveyed elsewhere. The 'Philosophy' section adds marginal value. The '⚠️ AskUserQuestion Guard' is useful but could be more concise. | 2 / 3 |
Actionability | The steps provide a reasonable workflow with some concrete guidance (bash prerequisites, token estimation formula, priority table), but key details are deferred to reference.md (manifest schema, baseline template, validation rules). The usage examples show file operations but not the actual skill invocation command, and the summarization step lacks executable code. | 2 / 3 |
Workflow Clarity | The 7-step workflow is clearly sequenced with explicit prerequisites, validation (checking folder existence, --force flag), a decision table for context sizing, and clear output expectations. The token thresholds and priority-based handling provide concrete decision points. The sub-agent delegation for large files is a clear escalation path. | 3 / 3 |
Progressive Disclosure | The skill provides a clear overview with well-structured sections and appropriately defers detailed schema, templates, and validation rules to a single reference.md file — one level deep. Navigation is clearly signaled at the end with a References section. | 3 / 3 |
Total | 10 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
Reviewed
Table of Contents