CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

risk-register

Maintain docs/RISK_REGISTER.md, the living, append-only list of every deferred item, interim shortcut, and open architecture decision for this project. Use when a shortcut is taken, a decision is postponed, a follow-up is filed, or an existing entry is actually resolved. DO NOT use for accepted, finalized architecture decisions (use adr-capture instead), for session-local working notes that don't need to survive across the team (use context-file / the local scratch-notes directory instead), or for anything that must stay confidential (the register is a committed, team-visible doc). Triggers: 'add to risk register', 'log this as a risk', 'track this shortcut', 'this is a known gap', 'mark risk #N resolved', 'what's on the risk register', 'what's still open'.

Quality

93%

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: concrete steps, copy-paste validation commands with expected outputs, a Definition of Done checklist, and error-recovery guidance for every failure mode. Its one weakness is verbosity -- the append-only and no-.context/-citation rules are each restated across several sections (schema, workflow, mindset, anti-patterns), which could be consolidated into a single authoritative statement.

Suggestions

Consolidate the append-only rule -- currently stated in the Row Schema table ('never reused or renumbered'), workflow step 4 ('Never insert out of # order, never renumber existing rows'), resolve step 3, the Mindset section, and two full Anti-Pattern blocks -- into the two Anti-Pattern entries and drop the restatements.

Fold the Mindset section's rationale into the relevant Anti-Pattern WHY clauses; the 'unenforced rule that's actually followed' paragraph restates what resolve step 3 and Anti-Pattern 2 already mandate.

Merge the .context/-citation prohibition, which appears in both workflow step 3 and Anti-Pattern 4, into a single anti-pattern with a one-line pointer from the workflow step.

DimensionReasoningScore

Conciseness

The append-only rule is restated across the Row Schema ('Permanent id, assigned once, never reused or renumbered'), workflow step 4 ('Never insert out of # order, never renumber existing rows'), resolve step 3 ('Never delete the row, never touch any column but Status/Date/Decision'), the Mindset section, and two full Anti-Pattern blocks; the .context/ citation prohibition likewise appears in both workflow step 3 and Anti-Pattern 4. Mostly efficient, but this cross-section repetition and the Mindset section's philosophical rationale ('An unenforced rule that's actually followed is worth more here than an enforced one that invites working around it') could be tightened. Not 4: the repetition spans multiple full sections, beyond 'minor instances'; not 2: each section is individually purposeful and nothing explains concepts Claude already knows.

3 / 5

Actionability

Fully concrete, executable guidance: 'Read the current last row's # in docs/RISK_REGISTER.md; the new row's # is that value + 1', copy-paste commands (scripts/validate-risk-register-append-only.sh, scripts/validate-risk-register-schema.sh) with expected output specified ('nothing printed, exit code 0'), a precise per-column Row Schema table, and a troubleshooting table mapping each failure mode to a specific fix. The common cases (add, resolve, pre-commit rejection) are all covered with concrete instructions.

5 / 5

Workflow Clarity

Both add and resolve workflows are numbered with explicit validation checkpoints ('Run both validation scripts and confirm each prints no error output and exits 0 before committing'; 'Re-run scripts/validate-risk-register-schema.sh and confirm it passes now that all three cells moved together'), plus a Definition of Done checklist and a Troubleshooting section providing fix-and-retry feedback loops for pre-commit rejections. This matches the top anchor's validate -> fix -> re-validate pattern exactly.

5 / 5

Progressive Disclosure

The body is a clear operational overview; both referenced files (references/relationship-to-sibling-conventions.md, references/unresolved-verification-case-study.md) exist, are one level deep, and are surfaced in a References table annotated with 'When to Use'. The row template and JSON schema are appropriately split into assets/templates/ and assets/schemas/, and both scripts referenced in the body exist in scripts/. Not 4: navigation is unambiguous and no content that belongs in a bundle file is inlined.

5 / 5

Total

18

/

20

Passed

Description

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

The description explicitly answers what it does, when to use it, and when not to use it, with named redirects to the two sibling skills that would otherwise collide. Its explicit trigger list covers both writing and querying phrasings. It is dense but every clause is functional rather than padded.

DimensionReasoningScore

Specificity

'Maintain docs/RISK_REGISTER.md, the living, append-only list of every deferred item, interim shortcut, and open architecture decision' names a concrete artifact and the specific actions of filing ('a follow-up is filed'), resolving ('an existing entry is actually resolved'), and querying. Multiple specific concrete actions with comprehensive coverage for this skill's scope, in third-person voice. Not 4: the action coverage (add, resolve, distinguish, query) is comprehensive rather than having minor gaps.

5 / 5

Completeness

What: 'Maintain docs/RISK_REGISTER.md, the living, append-only list of every deferred item, interim shortcut, and open architecture decision.' When: 'Use when a shortcut is taken, a decision is postponed, a follow-up is filed, or an existing entry is actually resolved' -- plus an explicit DO-NOT-use clause with concrete trigger phrases. Both what and when are answered explicitly and concretely, exceeding the top anchor's structure.

5 / 5

Trigger Term Quality

Explicit trigger phrases a user would naturally say: 'add to risk register', 'log this as a risk', 'track this shortcut', 'this is a known gap', 'mark risk #N resolved', 'what's on the risk register', 'what's still open'. Covers both write-side and read-side phrasings with synonyms. Not 4: the trigger list leaves no common variation missing for this domain.

5 / 5

Distinctiveness Conflict Risk

'DO NOT use for accepted, finalized architecture decisions (use adr-capture instead), for session-local working notes that don't need to survive across the team (use context-file / the local scratch-notes directory instead), or for anything that must stay confidential' actively disambiguates the two nearest sibling skills with named redirects. A clear niche with distinct triggers and minimal conflict risk.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 3 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

pantheon-org/tekhne

Path

skills/project-mgmt/risk-register/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.