CtrlK
BlogDocsLog inGet started
Tessl Logo

granola-reference-architecture

Enterprise reference architecture for meeting management with Granola. Use when designing org-wide meeting workflows, planning integration topology, or architecting meeting-to-action pipelines across departments. Trigger: "granola architecture", "granola enterprise design", "granola system design", "meeting system architecture".

62

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

50%

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

The body is a well-structured but verbose architecture reference: it supplies concrete topology, security, and routing specifics yet stays descriptive rather than executable, keeps all detail inline, and fails to signal the bundled reference file that duplicates much of its content.

Suggestions

Link references/implementation.md from the body and move the duplicated data-flow patterns (Step 5) and multi-workspace topology (Step 3) into it, leaving SKILL.md a concise overview — this improves both conciseness and progressive_disclosure.

Add actionable setup/configuration steps (e.g., the actual Zapier Path conditions, API calls, or workspace-creation commands) instead of only describing the target topology, to lift actionability.

Resolve the dangling 'Next Steps' pointer to granola-multi-env-setup (create the file or remove the forward reference) and add explicit validation checkpoints to the multi-step workflow.

DimensionReasoningScore

Conciseness

The body is dense structured data (ASCII diagrams, tables) rather than padded prose explaining concepts Claude knows, but it is long (~210 lines) and the Step 5 data-flow patterns overlap heavily with references/implementation.md, so it could be tightened.

2 / 3

Actionability

It provides concrete reference specifics (folder routing tables, retention days, AES-256/TLS 1.3 specs, compliance certs), but as an architecture blueprint it describes topology rather than giving executable setup commands or configuration steps.

2 / 3

Workflow Clarity

Six labeled Steps plus an Error Handling table give a recognizable sequence with some recovery guidance, but the steps read as topical sections rather than a validated workflow and lack explicit validation checkpoints.

2 / 3

Progressive Disclosure

Sections are well-organized with headers, but the architecture detail sits inline as a monolithic SKILL.md body and the existing references/implementation.md bundle file is never linked from the body; the 'Next Steps' reference to granola-multi-env-setup points to a non-existent file.

2 / 3

Total

8

/

12

Passed

Description

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.

The description is third-person, concrete, and complete, naming specific design actions alongside an explicit 'Use when' clause and a dedicated set of natural trigger phrases. It cleanly hits the top anchor on all four dimensions with no fluff or over-claims.

DimensionReasoningScore

Specificity

Names multiple concrete actions — 'designing org-wide meeting workflows, planning integration topology, or architecting meeting-to-action pipelines' — matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

Explicitly answers both what ('Enterprise reference architecture for meeting management with Granola') and when ('Use when designing org-wide meeting workflows...') with explicit triggers, satisfying the top anchor.

3 / 3

Trigger Term Quality

Provides natural trigger phrases a user would say — 'granola architecture', 'granola enterprise design', 'granola system design', 'meeting system architecture' — with good coverage of common variations.

3 / 3

Distinctiveness Conflict Risk

Granola-specific niche with distinct, branded triggers ('granola architecture', 'granola enterprise design') unlikely to fire for unrelated skills; clearly distinguishable.

3 / 3

Total

12

/

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.