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'.
82
77%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/risk-and-issues-manager/SKILL.mdQuality
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 lists specific concrete actions, provides an explicit 'Use when...' clause with diverse scenarios, and includes a dedicated 'Trigger on:' section with natural phrases users would actually say. The description is well-structured, uses third person voice throughout, and carves out a distinct niche combining RAID methodology with decision extraction from correspondence.
| Dimension | Reasoning | Score |
|---|---|---|
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). Both dimensions are thoroughly covered. | 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 highly natural phrases users would actually say. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a clear niche around RAID log methodology and decision extraction from correspondence. The combination of project risk management terminology and email/meeting note analysis creates a distinct profile unlikely to conflict with general document processing or generic project management skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
55%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill demonstrates deep domain expertise and provides highly actionable, concrete guidance for RAID log management and decision extraction. However, it is severely over-length, spending thousands of tokens on educational content about why RAID logs fail, what assumptions are, and philosophical distinctions that Claude can infer from concise instructions. The content would benefit enormously from splitting methodology/rationale into separate reference files and keeping the main skill focused on the operational process and field structures.
Suggestions
Extract the 'RAID methodology — the operational knowledge' section (why RAID logs fail, risk identification categories, risk assessment principles, materiality guidance) into a separate METHODOLOGY.md reference file, keeping only a one-line pointer in the main skill.
Remove or drastically condense explanatory passages that teach concepts rather than instruct actions — e.g., the paragraphs explaining what assumptions are, why decisions matter, and the Sibelius project case study. Claude understands these concepts; it needs the field structures and processing rules.
Move the 'Data storage vs reporting' section and format-specific guidance (docx, SharePoint, Excel) into a separate FORMATS.md file, referenced with a single line from the main skill.
Consolidate repeated guidance — the BLUF/presentation priority instructions appear in both Step 3 and the Output Format section with overlapping content. State once and reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | This skill is extremely verbose at ~4500+ words. It extensively explains concepts Claude already understands (what RAID logs are, why they fail, what decisions are, the difference between risks and issues), includes lengthy philosophical justifications, and repeats guidance multiple times. The 'Why most RAID logs fail' section, assumption lifecycle explanations, and extensive commentary on materiality are educational content that Claude doesn't need. The same skill could be delivered in roughly one-third the length. | 1 / 3 |
Actionability | The skill provides highly specific, concrete field structures for each RAID component (Issues, Risks, Assumptions, Decisions) with exact field names and values. The step-by-step process is detailed with specific triggers, decision extraction patterns with real examples ('let's leave Germany out for now'), output structures, and format-specific guidance for docx, Excel, and SharePoint. The examples of what to look for in emails are specific and actionable. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced: determine mode → process input → produce output → write summary. The risk-to-issue escalation has explicit steps with validation (assess mitigation effectiveness, escalate appropriately). Mode determination has clear triggers. The output structure has explicit ordering (BLUF first, then counters, then detail in IRAD order). The feedback loop for assumption lifecycle (Untested → Validated/Failed → Risk/Issue) is well-defined. | 3 / 3 |
Progressive Disclosure | This is a monolithic wall of text with no references to external files. The extensive methodology sections (why RAID logs fail, risk identification categories, assumption lifecycle, LPM vs attorney boundary) could easily be split into separate reference documents. Everything is inline, making the skill overwhelming to parse. There are cross-skill handoff points mentioned but no actual file references for detailed content that could be externalized. | 1 / 3 |
Total | 8 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
8f9093f
Table of Contents
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.