CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

decision-logger

Two-layer memory architecture for board meeting decisions. Manages raw transcripts (Layer 1) and approved decisions (Layer 2). Use when logging decisions after a board meeting, reviewing past decisions with /decision-logger decisions, or checking overdue action items with /decision-logger review. Invoked automatically by the board-meeting skill after Phase 5 founder approval.

71

Quality

89%

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

SKILL.md
Quality
Evals
Security

Quality

Content

85%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.

Highly actionable, well-sequenced content with a genuinely executable workflow and verified CLI support. The main defects are a broken reference to a missing templates/decision-entry.md file and minor token padding (the Keywords section and the redundant opening paragraph).

Suggestions

Create the referenced templates/decision-entry.md file (or remove the References entry pointing to it) — the path currently resolves to nothing in the bundle.

Delete the "Keywords" section and the opening paragraph that restates the frontmatter description; trigger terms belong in the description field, and duplicating them spends tokens without adding guidance.

Qualify or inline the dependency on "../agent-protocol/SKILL.md → Decision Memory (Canonical Layout)" so the skill degrades gracefully when that sibling skill is absent, and mention conflict detection in the description since it is a core capability.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence (paths, commands, and templates with no concept explanations), but includes trimmable padding: a "Keywords" section that duplicates the frontmatter description's trigger terms and an intro sentence that restates the description. Not 5 because those sections spend tokens without adding guidance; not 3 because there is no over-explanation of things Claude already knows.

4 / 5

Actionability

Fully executable throughout: six copy-paste Quick Start commands, a Commands table, exact storage paths, a complete decision-entry markdown template, and exact conflict-alert/block message formats. The documented CLI flags (--demo, --summary, --overdue, --conflicts, --owner, --search) were verified to exist in the bundled scripts/decision_tracker.py.

5 / 5

Workflow Clarity

The "Logging Workflow (Post Phase 5)" is a clear 6-step sequence with an explicit validation checkpoint ("Check conflicts against ~/.claude/decisions/approved/decisions.md"), a feedback loop ("Surface conflicts → wait for founder resolution" with three enumerated resolution options), and a final confirmation step. Operations are append-only rather than destructive, so no missing-validation cap applies.

5 / 5

Progressive Disclosure

Sections are well-organized and references are clearly signaled one level deep, but scoring against the actual bundle shows the References section points to "templates/decision-entry.md", which does not exist in the bundle (no templates/ directory), and the body's pointer to "../agent-protocol/SKILL.md" is unresolvable from this skill. Only scripts/decision_tracker.py is present. Not 4 because a broken referenced path is more than a minor organization gap; not 2 because the structure and signaling are otherwise good.

3 / 5

Total

17

/

20

Passed

Description

87%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: concrete actions, an explicit 'Use when...' clause with specific trigger commands, and a well-scoped niche. The main gap is that conflict detection and DO_NOT_RESURFACE enforcement — prominent features in the body — are not surfaced in the description.

DimensionReasoningScore

Specificity

Quotes several concrete actions — "Manages raw transcripts (Layer 1) and approved decisions (Layer 2)", "logging decisions after a board meeting", "reviewing past decisions", "checking overdue action items" — but coverage has minor gaps (conflict detection and DO_NOT_RESURFACE enforcement, core features per the body, are not mentioned). Not 3 because it lists more than 1-2 concrete actions; not 5 because coverage is not comprehensive.

4 / 5

Completeness

Explicitly answers both: what ("Two-layer memory architecture for board meeting decisions. Manages raw transcripts (Layer 1) and approved decisions (Layer 2)") and when ("Use when logging decisions after a board meeting, reviewing past decisions with /decision-logger decisions, or checking overdue action items with /decision-logger review"). The 'when' clause is explicit with concrete trigger phrases, matching the 5 anchor; a 4 would require the 'when' to be less specific.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "board meeting", "logging decisions", "overdue action items", "approved decisions", plus the explicit commands "/decision-logger decisions" and "/decision-logger review". Not 5 because common synonyms users might say ("board minutes", "follow-ups", "decision log") are missing.

4 / 5

Distinctiveness Conflict Risk

Clear niche (board-meeting decision memory) with distinct triggers including skill-specific slash commands and "Invoked automatically by the board-meeting skill after Phase 5 founder approval", which further scopes it. Minimal conflict risk with other skills; not 4 because the triggers are unambiguous rather than having minor overlap.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

alirezarezvani/claude-skills

Path

c-level-advisor/skills/decision-logger/SKILL.md

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.