Pin session decisions, questions, constraints, and corrections to a persistent board that survives context compaction.
89
89%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Risky
Do not use without reviewing
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 an excellent skill description that clearly articulates what the skill does (pins session decisions, questions, objections, scope constraints, and corrections to a persistent board), when to use it (with detailed proactive triggers and explicit user commands), and includes strong natural trigger terms. The description is comprehensive yet focused, with a distinct niche that minimizes conflict risk with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: pin session decisions, questions, objections, scope constraints, and corrections to a persistent board. Also specifies the board survives context compaction, which is a concrete technical detail. | 3 / 3 |
Completeness | Clearly answers both 'what' (pin decisions, questions, objections, scope constraints, corrections to a persistent board) and 'when' with explicit, detailed trigger conditions including both proactive scenarios (numbered list) and explicit user commands. The 'Use PROACTIVELY when' and 'Also use when' clauses are thorough. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'pin', 'track this', 'mark as approved', 'board', 'show pins'. Also includes implicit triggers like approvals, rejections, clarifying questions, scope constraints, and corrections that map to natural conversational patterns. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a clear niche around persistent decision/constraint tracking across context compaction. The specific focus on pinning session artifacts to a board is distinct and unlikely to conflict with other skills like note-taking or task management. | 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 well-designed, highly actionable skill with clear command definitions, explicit workflows, and good error handling. Its main weakness is verbosity — the anti-patterns with 'Why' explanations, overlapping 'When to Use'/'When Not to Use' sections, philosophy section, and external references inflate the token cost without adding proportional value. Trimming redundant sections could cut 30-40% of tokens while preserving all actionable content.
Suggestions
Merge 'When to Use', 'When Not to Use', and 'Do NOT pin' into a single compact section, removing overlap with 'Auto-Invoke Rules'.
Remove the 'Why' explanations from anti-patterns — Claude doesn't need rationale for each rule; the rule itself is sufficient.
Remove the 'Philosophy' and 'References' sections, which add no actionable guidance and consume tokens.
Consider moving 'Usage Examples' to a separate file and linking from the main skill, since the auto-invoke examples at the top already demonstrate usage patterns.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is well-structured but verbose for what it does. The 'When to Use', 'When Not to Use', and 'Anti-Patterns' sections heavily overlap with the 'Auto-Invoke Rules' and 'Do NOT pin' sections, and the 'Philosophy' section restates what's already clear from the design. The anti-patterns section explains 'Why' for each point, which is unnecessary for Claude. The references at the end add no actionable value. | 2 / 3 |
Actionability | Highly actionable with concrete commands, exact JSON schema, bash path derivation, emoji-to-type mapping, specific response formats, and complete worked examples. Every operation (pin, show, rm, clear, clear triage) has explicit step-by-step instructions with exact output formats. | 3 / 3 |
Workflow Clarity | Each command has a clearly numbered sequence of steps with validation checkpoints (duplicate check, limit check, file existence check). Error cases are handled explicitly (pin not found, already pinned, category full with oldest-drop policy). The auto-invoke flow is clearly sequenced: respond normally → then pin. | 3 / 3 |
Progressive Disclosure | Content is well-organized with clear section headers and a logical flow from rules to commands to implementation details. However, the skill is quite long (~200 lines) and could benefit from splitting the detailed anti-patterns, usage examples, and philosophy into a separate reference file, keeping SKILL.md as a tighter overview. | 2 / 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