CtrlK
BlogDocsLog inGet started
Tessl Logo

pantheon-ai/pin

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

73

Quality

92%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Overview
Quality
Evals
Security
Files

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with concrete commands, a JSON schema, executable bash, and well-sequenced workflows including duplicate and limit validation. Its main weakness is redundancy: triggers and prohibitions are restated across several sections, inflating the token budget without adding operational value.

Suggestions

Consolidate the auto-invoke triggers, 'When to Use', 'When Not to Use', and 'Anti-Patterns' sections — they restate the same five trigger categories and the same prohibitions multiple times; merge into a single triggers list and a single anti-patterns list.

Trim the Usage Examples section to one or two representative cases, since the response format is already specified verbatim in the per-command sections.

Remove restated constraints (e.g. the 5-per-type/20-total limit appears in both the Pin procedure and a dedicated Limits section) and keep a single authoritative location.

DimensionReasoningScore

Conciseness

The body is mostly efficient and actionable, but the Auto-Invoke Rules, When to Use, When Not to Use, Anti-Patterns, and Usage Examples sections substantially restate the same triggers and prohibitions already covered, adding length without new operational information.

2 / 3

Actionability

Each command has a numbered procedure, a concrete JSON schema, an executable slug-derivation bash block, and copy-paste-ready example invocations with exact response strings.

3 / 3

Workflow Clarity

Pin/Show/Remove/Clear workflows are explicitly sequenced with validation checkpoints (duplicate check before write, not-found handling, limit enforcement with oldest-drop), satisfying the feedback-loop requirement for batched file writes.

3 / 3

Progressive Disclosure

For a self-contained skill with no bundle files, content is organized into clearly labeled sections (State File, Commands, Philosophy, Key Behaviors) with the two external references cleanly isolated in a References section.

3 / 3

Total

11

/

12

Passed

Description

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.

The description is concrete, well-triggered, and complete, naming specific actions and providing both explicit 'Use when' guidance and natural trigger terms. It is written in the correct third-person imperative voice without first/second-person slips.

DimensionReasoningScore

Specificity

The description enumerates concrete actions across five categories — pinning approved items, pending questions, killed/rejected items, scope constraints, and corrections — plus the show/remove/clear operations, matching the 'multiple specific concrete actions' anchor.

3 / 3

Completeness

It states both what the skill does ('Pin session decisions, questions, objections, scope constraints, and corrections to a persistent board') and when to use it via an explicit 'Use PROACTIVELY when' clause and an auto-invoke rule, satisfying the what-and-when anchor.

3 / 3

Trigger Term Quality

It lists natural trigger phrases users would say ('pin', 'track this', 'mark as approved', 'board', 'show pins') and five real-world example utterances, giving strong coverage of natural terms.

3 / 3

Distinctiveness Conflict Risk

The pin-board niche is clearly scoped to surviving context compaction with distinct emoji-prefixed triggers, making conflict with other skills unlikely.

3 / 3

Total

12

/

12

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 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

14

/

16

Passed

Reviewed

Table of Contents