3Scribe integration. Manage data, records, and automate workflows. Use when the user wants to interact with 3Scribe data.
61
72%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/3scribe/SKILL.mdQuality
Discovery
67%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 benefits from having an explicit 'Use when' clause and naming the specific integration (3Scribe), which aids in selection. However, the actions described are quite generic ('manage data, records, automate workflows') and don't convey what specific capabilities the skill provides, making it hard to distinguish from other data management or integration skills beyond the brand name.
Suggestions
Replace generic actions with specific concrete operations, e.g., 'Create, update, and query 3Scribe transcription records, manage audio files, and automate transcription workflows.'
Add more natural trigger terms users might say, such as specific 3Scribe features, file types, or use cases (e.g., 'transcription', 'audio processing', 'speech-to-text').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (3Scribe) and some general actions ('manage data, records, and automate workflows'), but these actions are broad and not concrete—it doesn't specify what kind of data, records, or workflows, or what specific operations (create, update, delete, query) are supported. | 2 / 3 |
Completeness | It answers both 'what' (manage data, records, automate workflows) and 'when' (Use when the user wants to interact with 3Scribe data), with an explicit 'Use when' clause providing trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes the key trigger term '3Scribe' which is essential for matching, plus generic terms like 'data', 'records', and 'workflows'. However, it lacks more specific natural language terms users might say (e.g., transcription, audio, specific 3Scribe features) and common variations. | 2 / 3 |
Distinctiveness Conflict Risk | The '3Scribe' brand name provides some distinctiveness, but the generic terms 'manage data, records, and automate workflows' could overlap with many other integration or data management skills. The 'when' clause is also very broad ('interact with 3Scribe data'). | 2 / 3 |
Total | 9 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid integration skill with excellent actionability and workflow clarity — every step has executable commands and the connection state machine is well-documented with clear branching logic. The main weaknesses are unnecessary introductory context about what 3Scribe is, some padding in explanations, and an incomplete popular actions table with empty descriptions that wastes tokens without adding value.
Suggestions
Remove the introductory paragraph explaining what 3Scribe is — Claude doesn't need this context to use the integration.
Fill in the descriptions for the popular actions table or remove it entirely; empty description cells waste tokens.
Trim filler phrases like 'so you can focus on the integration logic rather than auth plumbing' to improve token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The opening paragraph explaining what 3Scribe is and who uses it is unnecessary context for Claude. The Membrane CLI explanation is mostly efficient but includes some padding like 'so you can focus on the integration logic rather than auth plumbing.' The popular actions table has empty description fields, wasting space. | 2 / 3 |
Actionability | The skill provides fully executable CLI commands for every step: installation, authentication, connection setup, action discovery, action execution, and proxy requests. Commands are copy-paste ready with clear flag documentation and JSON parameter examples. | 3 / 3 |
Workflow Clarity | The connection workflow is clearly sequenced with explicit state-based branching (READY, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR). There's a clear polling/retry loop for BUILDING state, and the workflow handles error states with guidance on what to check. The overall flow from install → auth → connect → discover → run is well-structured. | 3 / 3 |
Progressive Disclosure | The content is reasonably structured with clear sections, but it's somewhat monolithic for its length. The popular actions table with empty descriptions adds no value. There are no bundle files or references to external detailed docs beyond the official docs link, and some sections (like the proxy request flags table) could be separated for better organization. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
f484c82
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.