CtrlK
BlogDocsLog inGet started
Tessl Logo

granola-incident-runbook

Incident response procedures for Granola meeting capture failures and outages. Use when meetings aren't recording, transcription fails mid-meeting, integrations stop syncing, or the Granola service is down. Trigger: "granola incident", "granola outage", "granola down", "granola not recording", "granola emergency".

64

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

65%

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

A genuinely actionable, well-structured incident runbook with concrete commands and templates. Its main gaps are implicit verification checkpoints and an orphaned, duplicative reference file that undermines progressive disclosure.

Suggestions

Add explicit verification checkpoints after each remediation (e.g., 'Confirm recording resumed' / 'Verify sync succeeded') so the workflow has a validate-then-proceed loop.

Link references/implementation.md from the body where deeper detail lives, or remove it if the inline content is intended to be canonical — currently it is an unreferenced duplicate.

Deduplicate the Slack notification and post-incident report templates between SKILL.md and implementation.md, keeping one canonical version.

DimensionReasoningScore

Conciseness

The runbook is mostly lean — tables, checklists, and command blocks earn their place — but the inline Slack and post-incident report templates duplicate content already present in references/implementation.md, and several status-page mentions repeat across sections.

2 / 3

Actionability

Concrete executable commands ('curl -s ...status.json', 'pgrep -l Granola', 'pkill -9 Granola'), exact UI navigation paths (Settings > Integrations), a per-integration fix table, and a copy-paste Slack message template give fully actionable guidance.

3 / 3

Workflow Clarity

Steps are clearly sequenced (Triage → Remediation → Escalation → Post-Incident) with a severity matrix, but verification checkpoints — confirming a fix actually resolved the incident before moving on — are largely implicit rather than explicit.

2 / 3

Progressive Disclosure

The body is well-sectioned, but references/implementation.md is never linked or signaled from SKILL.md (Next Steps points to an unrelated skill instead), and that file duplicates the same incident coverage rather than splitting detail one level deep.

2 / 3

Total

9

/

12

Passed

Description

90%

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 well-formed description that clearly states purpose and explicit trigger guidance in third person. The only weakness is that the action vocabulary is generic ('procedures') rather than enumerating the concrete response actions the runbook actually performs.

DimensionReasoningScore

Specificity

Names the Granola domain and concrete failure modes ('meeting capture failures', 'transcription fails mid-meeting', 'integrations stop syncing', 'service is down') but the actions stay abstract ('Incident response procedures') rather than listing concrete operations like triage, remediate, escalate.

2 / 3

Completeness

It answers 'what' ('Incident response procedures for Granola meeting capture failures and outages') and 'when' with an explicit 'Use when...' clause plus a Trigger line, satisfying both halves.

3 / 3

Trigger Term Quality

The Trigger line supplies natural user phrases — 'granola incident', 'granola outage', 'granola down', 'granola not recording', 'granola emergency' — that a user would plausibly say when they need this skill.

3 / 3

Distinctiveness Conflict Risk

Scoped to a single named SaaS product (Granola) with product-specific triggers, giving it a clear niche unlikely to collide with other skills.

3 / 3

Total

11

/

12

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
jeremylongshore/claude-code-plugins-plus-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.