CtrlK
BlogDocsLog inGet started
Tessl Logo

pin

Pin session decisions, questions, objections, scope constraints, and corrections to a persistent board that survives context compaction. Use PROACTIVELY when: (1) user approves/rejects a recommendation, (2) user asks a clarifying question about a proposal, (3) user states a scope constraint, (4) user corrects a misunderstanding. Also use when user says pin, track this, mark as approved, board, show pins. Auto-invoke without user asking whenever a decision, question, or constraint is detected.

65

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/agentic-harness/pin/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%Weight 40%Scale 1-5

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 exact schemas, commands, and response formats, and is well structured for a self-contained skill. Its weaknesses are redundancy — trigger guidance repeated across Auto-Invoke Rules, When to Use, When Not to Use, and Usage Examples — and missing validation on the destructive batch operations (/pin clear, silent overflow eviction), which caps workflow clarity.

Suggestions

Consolidate the overlapping trigger guidance: merge the Auto-Invoke Rules examples, When to Use bullets, and Usage Examples into a single section, since the same pin scenarios are demonstrated three times.

Add validation to destructive and batch operations: confirm or echo a count before `/pin clear`, and notify the user when the per-type limit silently evicts the oldest pin ("⚠️ Dropped #N to make room").

Trim the Philosophy section and the Anti-Pattern 'Why:' rationales to one line each, or move worked examples and anti-pattern rationale into a reference file to slim the main body.

DimensionReasoningScore

Conciseness

The body is mostly efficient (commands table, exact JSON schema, terse procedures) but restates the same trigger guidance four times — "Examples of auto-invoke triggers" in Auto-Invoke Rules, the When to Use bullets, the When Not to Use / Do NOT pin lists, and three Usage Examples that re-demonstrate the same pin calls. The Philosophy section also pads ("A well-run session generates fewer than 20 pins"); the content could be tightened by collapsing these overlapping sections.

3 / 5

Actionability

Guidance is fully concrete and executable: a copy-paste bash snippet for deriving PINS_FILE, an exact JSON schema with a worked example item, numbered steps per command, explicit limit rules ("5 items per type, 20 total"), exact one-line response strings, and a real parsing gotcha (split on first emoji, not first space). Common cases are covered by worked examples.

5 / 5

Workflow Clarity

Each command has a numbered sequence, and the primary pin flow includes checkpoints (duplicate check in step 4, limit check in step 5; rm handles "Pin #N not found"). However, destructive/batch operations lack validation: `/pin clear` wipes the board with no verification, and the overflow rule silently drops the oldest item of a type without notifying the user. Per the rubric guideline, missing validation in destructive or batch workflows caps this dimension at 3 even though the sequence itself is clear.

3 / 5

Progressive Disclosure

The single-file body is well organized with clear section headers (Commands, State File, per-command sections, Limits, Anti-Patterns, Usage Examples) and no nested references — the References section points one level deep to external URLs only. Not a 5 because the ~200-line body (three Usage Examples plus verbose Anti-Patterns with rationale) could split some material into a reference file, and the external links add little operational value.

4 / 5

Total

15

/

20

Passed

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that clearly and explicitly states both what the skill does and when to use it, in third person, with concrete behavioral triggers and natural keyword phrases. The only weaknesses are unmentioned management commands and a slightly over-broad auto-invoke clause that raises mild conflict risk.

DimensionReasoningScore

Specificity

"Pin session decisions, questions, objections, scope constraints, and corrections to a persistent board that survives context compaction" names the domain, a concrete capture action, five specific item categories, and the persistence mechanism. Not a 5 because the board-management actions (show/remove/clear) are absent from the description; not a 3 because it goes beyond 1-2 generic actions with enumerated object types and an explicit durability property.

4 / 5

Completeness

Both halves are explicit: the first sentence answers what (pin decisions/questions/objections/constraints/corrections to a persistent board surviving compaction), and "Use PROACTIVELY when" plus the keyword list answers when with concrete trigger phrases. This matches the 5 anchor directly; the when-clause is neither missing nor merely implied.

5 / 5

Trigger Term Quality

"Use PROACTIVELY when: (1) user approves/rejects a recommendation... (4) user corrects a misunderstanding. Also use when user says pin, track this, mark as approved, board, show pins" gives comprehensive natural trigger phrases plus four behavioral conditions a user would genuinely exhibit. Nothing material is missing for this domain.

5 / 5

Distinctiveness Conflict Risk

The session-decision-pinning niche is distinct with dedicated triggers ("pin", "mark as approved", "board"). Not a 5 because "Auto-invoke without user asking whenever a decision, question, or constraint is detected" is broad enough to overlap with note-taking/todo-tracking skills and to fire on ordinary clarifying questions.

4 / 5

Total

18

/

20

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

Repository
pantheon-org/tekhne
Reviewed

Table of Contents

Is this your skill?

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.