Name: documenterra
Rating: 68.8 (1 reviews)
Author: membranedev

documenterra

Documenterra integration. Manage Documents, Folders, Users, Groups, Tags. Use when the user wants to interact with Documenterra data.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

88%Weight 40%Scale 1-5

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, executable CLI integration guide with a clear workflow and an explicit polling/validation feedback loop for connection readiness. It is largely concise and actionable, with only minor trimming and organization opportunities.

Suggestions

Trim editorial padding such as 'so you can focus on the integration logic rather than auth plumbing' and 'This is the fastest way to get a connection' to recover a few tokens.

Consider moving the full 'Popular actions' list and proxy flag reference into a separate reference file, keeping SKILL.md as a tighter overview with one-level-deep pointers.

Dimension	Reasoning	Score
Conciseness	Largely efficient command-driven prose with tight code blocks and a flags table. A few soft sentences ('so you can focus on the integration logic rather than auth plumbing', 'This is the fastest way to get a connection') could be trimmed, keeping it just below the lean/efficient top anchor.	4 / 5
Actionability	Copy-paste-ready, fully executable commands throughout — 'npm install -g @membranehq/cli@latest', 'membrane connection ensure', 'membrane action run ... --input', plus a proxy flags table — covering the common cases with concrete parameters.	5 / 5
Workflow Clarity	Clear sequenced workflow (install → authenticate → connect → search → run → proxy) with an explicit validation feedback loop: '--wait' polling and state branching into READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR with 'poll again until READY' recovery guidance.	5 / 5
Progressive Disclosure	Well-sectioned single-file skill with clear headers (Overview, Authentication, Connecting, Searching, Popular actions, Best practices). No bundle files exist, so all content is inline; the inline 'Popular actions' table is appropriate, but the skill leans on a single monolithic file rather than splitting detailed reference material out.	4 / 5
	Total	18 / 20 Passed

Description

78%Weight 40%Scale 1-5

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 clearly identifies the domain and lists concrete managed entities, with an explicit 'Use when' clause covering both what and when. Trigger terms are natural but lack synonyms/file extensions, keeping it just short of the top anchor.

Suggestions

Expand the 'Use when' clause with concrete trigger phrases (e.g. 'Use when the user wants to list, create, or search Documenterra documents, projects, or pages').

Add common synonyms or file-format hints (e.g. 'publications', 'articles', '.docx') so the description matches a wider range of natural user phrasings.

Dimension	Reasoning	Score
Specificity	Quotes 'Manage Documents, Folders, Users, Groups, Tags' — names the domain and lists several specific concrete entities to manage. Falls below 5 because these are managed object types rather than multiple distinct verb-based actions; above 3 because coverage is broad and concrete.	4 / 5
Completeness	Both 'what' ('Manage Documents, Folders, Users, Groups, Tags') and an explicit 'when' ('Use when the user wants to interact with Documenterra data') are present. Below 5 because the 'when' clause is generic rather than enumerating concrete trigger phrases.	4 / 5
Trigger Term Quality	Natural terms like 'Documents, Folders, Users, Groups, Tags' and 'interact with Documenterra data' are present and would be said by users. Below 5 because common synonyms/extensions a user might say (e.g. 'files', 'publications', 'pages', '.pdf') are missing.	4 / 5
Distinctiveness Conflict Risk	Names a specific named product ('Documenterra') and scoped entity types, giving it a clear niche with minimal risk of triggering for unrelated skills.	5 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: membranedev/application-skills
Path: skills/documenterra/SKILL.md
Commit: f484c82

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.