CtrlK
BlogDocsLog inGet started
Tessl Logo

risk-and-issues-manager

RAID log methodology with decision extraction from emails and meeting notes. Use when asked to identify risks, log assumptions, track issues, extract decisions from correspondence, create or update a RAID log, escalate a risk to an issue, assess project risks, validate or challenge assumptions, or capture scope-relevant decisions. Also triggers when the user pastes email chains and asks what decisions were made, or needs to find buried decisions and untested assumptions in correspondence. Trigger on: 'risk report', 'RAID log', 'what are the risks', 'what decisions were made', 'update the risk register', 'what assumptions are we making', 'what could go wrong', 'flag any issues', 'extract decisions from these emails'.

56

Quality

63%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/risk-and-issues-manager/SKILL.md
SKILL.md
Quality
Evals
Security

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 thoroughly covers capabilities, trigger conditions, and natural user language. It uses third person voice consistently, provides both a 'Use when' clause and explicit trigger phrases, and carves out a distinctive niche combining RAID log management with decision extraction from correspondence. It serves as a strong example of a well-crafted skill description.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: identify risks, log assumptions, track issues, extract decisions from correspondence, create/update RAID log, escalate risk to issue, assess project risks, validate/challenge assumptions, capture scope-relevant decisions.

3 / 3

Completeness

Clearly answers both 'what' (RAID log methodology with decision extraction from emails and meeting notes) and 'when' (explicit 'Use when...' clause with detailed trigger scenarios, plus a 'Trigger on:' list of specific phrases).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms including 'risk report', 'RAID log', 'what are the risks', 'what decisions were made', 'update the risk register', 'what assumptions are we making', 'what could go wrong', 'flag any issues', and 'extract decisions from these emails'. These are phrases users would naturally say.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche around RAID log methodology and decision extraction from correspondence. The combination of project risk management and email/meeting note analysis creates a unique, well-defined scope unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

27%

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

This skill contains genuinely valuable domain knowledge about RAID log management and decision extraction from correspondence, with well-structured field definitions and clear categorization guidance. However, it is severely over-length, reading more like a comprehensive training manual than a skill file for Claude. The lack of concrete input/output examples, missing validation checkpoints, and monolithic structure significantly reduce its effectiveness as an operational instruction set.

Suggestions

Reduce the body to ~30% of current length by extracting the RAID methodology section, field structure definitions, and format-specific guidance into separate referenced files (e.g., RAID_METHODOLOGY.md, FIELD_STRUCTURES.md, FORMAT_GUIDE.md)

Add a concrete worked example showing an actual email snippet being processed into specific RAID log entries, demonstrating the expected input→output transformation

Remove educational content Claude already knows (what PDFs are equivalent: what RAID stands for, why project management discipline matters, general risk assessment philosophy) and keep only the specific classification rules and decision criteria

Add explicit validation checkpoints: after extraction, confirm entries with user before logging; after updating existing log, verify no ID conflicts or duplicate entries; after classification, verify risk vs issue distinction with the transition test

DimensionReasoningScore

Conciseness

This skill is extremely verbose at ~4500+ words. It extensively explains concepts Claude already understands (what RAID logs are, why decisions matter, why assumptions fail, general project management philosophy). Large sections like 'Why most RAID logs fail,' the Sibelius project references, and lengthy explanations of risk assessment principles are educational content that Claude doesn't need. The 'silence is a risk, not an issue' section alone spans multiple paragraphs explaining a simple classification rule. Much of this reads like a training manual for a human LPM rather than concise instructions for Claude.

1 / 3

Actionability

The skill provides detailed field structures for each RAID component (Issues, Risks, Assumptions, Decisions tables) which are concrete and actionable. The step-by-step process and decision extraction signals are specific. However, there are no executable code examples, no concrete input/output examples showing an actual email chain being processed into RAID entries, and no template showing what a completed extraction looks like. The guidance is detailed but largely descriptive rather than demonstrative.

2 / 3

Workflow Clarity

The 4-step process (determine mode → process input → produce output → write summary) is clearly sequenced, and the risk-to-issue escalation has explicit steps. However, validation checkpoints are largely absent — there's no explicit verification step after extraction ('confirm these entries with the user before adding to the log'), no feedback loop for when the user disagrees with a classification, and no checkpoint for confirming the output matches the existing log structure when updating. The 'confirming the full picture' section is a partial validation step but it's buried deep in the document.

2 / 3

Progressive Disclosure

This is a monolithic wall of text with no bundle files and no references to external documents. Content that could easily be split — the detailed RAID methodology section, the field structure definitions, the format-specific guidance, the M365 connected mode section — is all inline. The skill references other skills (scope-change-controller, budget-and-fee-manager, etc.) but doesn't reference any supporting files for its own detailed content. At this length, the lack of any content splitting is a significant organizational failure.

1 / 3

Total

6

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
legalopsconsulting/lpm-skills
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.