Configure Granola across multiple workspaces and teams with SSO/SCIM provisioning. Use when setting up department-level workspaces, configuring user provisioning, or managing enterprise-scale Granola deployments. Trigger: "granola workspaces", "granola multi-team", "granola SSO", "granola SCIM", "granola organization setup".
59
70%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/saas-packs/granola-pack/skills/granola-multi-env-setup/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 a strong skill description that clearly defines its scope around Granola enterprise configuration with SSO/SCIM provisioning. It provides explicit 'Use when' guidance and a dedicated trigger term list, making it easy for Claude to select appropriately. The description is concise, uses third-person voice, and covers both capabilities and activation conditions thoroughly.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: configuring across multiple workspaces and teams, SSO/SCIM provisioning, setting up department-level workspaces, configuring user provisioning, and managing enterprise-scale deployments. | 3 / 3 |
Completeness | Clearly answers both 'what' (configure Granola across workspaces/teams with SSO/SCIM) and 'when' (explicit 'Use when' clause covering department-level workspaces, user provisioning, enterprise-scale deployments), plus an explicit trigger list. | 3 / 3 |
Trigger Term Quality | Includes natural, specific trigger terms like 'granola workspaces', 'granola SSO', 'granola SCIM', 'granola organization setup', and 'granola multi-team' that users would realistically use when needing this skill. The explicit trigger list covers key variations. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: Granola-specific enterprise/multi-workspace configuration with SSO/SCIM. The combination of product name (Granola) and enterprise provisioning concepts makes it very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
39%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a thorough walkthrough of multi-workspace Granola setup with good workflow sequencing and validation, but it is far too verbose for a skill file. The extensive hypothetical department tables and role matrices are example data that Claude could generate from minimal guidance, wasting significant token budget. The content would benefit greatly from being split into a concise overview SKILL.md with detailed reference tables in separate bundle files.
Suggestions
Reduce the skill to ~50% of its current length by removing hypothetical department-specific tables (Engineering, Sales, HR, etc.) and replacing them with a single generic example row plus a note that Claude should adapt to the user's org structure.
Extract the role hierarchy table, compliance controls table, and integration mapping table into separate bundle reference files (e.g., ROLES.md, COMPLIANCE.md) and reference them from the main skill.
Replace the pseudo-config block in Step 5 with a note about which settings to configure, since the format shown isn't an actual Granola configuration syntax and could mislead.
Add concrete verification commands or API calls where possible (e.g., SCIM test endpoint calls) rather than relying solely on UI navigation instructions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose with large tables of hypothetical department configurations that are essentially example data, not actionable instructions. Much of the content (workspace planning tables, integration mapping tables, role hierarchy tables) is padding that Claude could generate on its own given minimal guidance. The skill reads more like a blog post or onboarding guide than a concise skill file. | 1 / 3 |
Actionability | The steps provide some concrete guidance (specific URLs for SSO endpoints, SCIM configuration steps, settings paths), but most of the content is navigational ('go to Settings > X') rather than executable. There are no API calls, CLI commands, or scripts — just UI navigation instructions and hypothetical configuration tables. The compliance hardening block is the closest to actionable but uses a pseudo-config format that isn't a real Granola configuration syntax. | 2 / 3 |
Workflow Clarity | The 7-step sequence is logically ordered (plan → create → provision → integrate → compliance → permissions → validate). Step 7 includes an explicit validation checklist with checkboxes covering each prior step, plus ongoing monitoring cadence. The error handling table provides a feedback loop for common failure modes. This is a well-structured workflow with clear validation checkpoints. | 3 / 3 |
Progressive Disclosure | The skill is a monolithic wall of text with no bundle files to offload detailed content. The extensive tables for workspace planning, integration mapping, compliance controls, and role hierarchy should be in separate reference files. There are no internal cross-references to supporting documents, and the single 'Next Steps' reference to 'granola-observability' is the only navigation aid. The Resources section links to external docs but doesn't structure the skill's own content across files. | 1 / 3 |
Total | 7 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | 9 / 11 Passed | |
d41e58e
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.