CtrlK
BlogDocsLog inGet started
Tessl Logo

pantheon-ai/pin

Pin session decisions, questions, constraints, and corrections to a persistent board that survives context compaction.

89

Quality

89%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Overview
Quality
Evals
Security
Files

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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