CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

autodesk-revit

Autodesk Revit integration. Manage data, records, and automate workflows. Use when the user wants to interact with Autodesk Revit data.

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/autodesk-revit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 delivers concrete, largely copy-paste-ready CLI commands with a sensible overall flow and a genuinely useful connection-state handling loop. Its weaknesses are padding (the Revit explainer paragraph), a workflow whose step references point to unlabeled steps, and no use of reference files to separate detail (proxy options, clientAction schema) from the core path.

Suggestions

Delete the 'Autodesk Revit is a BIM software...' overview paragraph and the 'Use action names and parameters as needed.' filler — Claude already knows what Revit is.

Number the workflow steps explicitly (1. Install, 2. Authenticate, 3. Connect, 4. Search actions, 5. Run) so the existing 'skip to Step 2' reference resolves, and add a brief error-handling/validation note for action runs (e.g. inspect the output/error fields and retry guidance).

Move the proxy request options table and the clientAction field-by-field documentation into a references/ file (e.g. REFERENCES.md) and link to it from the main flow, keeping SKILL.md as a lean overview.

Consolidate the duplicated action-discovery guidance in 'Searching for actions' and 'Popular actions' into a single section with one realistic filled-in example (actual connection id, intent, and a sample response).

DimensionReasoningScore

Conciseness

The opening paragraph ('Autodesk Revit is a BIM (Building Information Modeling) software... Revit helps streamline workflows from concept to construction') explains a concept Claude already knows, and filler like 'Use action names and parameters as needed.' adds nothing. Otherwise the body is mostly efficient commands, matching the anchor 'Mostly efficient but includes some unnecessary explanation or could be tightened' — not level 2 since only one section is clearly padded, and not level 4 because the overview paragraph and filler lines should be trimmed.

3 / 5

Actionability

Commands are concrete and executable throughout: 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://www.autodesk.com/products/revit/overview" --json', 'membrane action run <actionId> --connectionId=... --input {...}'. This matches 'Mostly executable guidance; concrete code or commands with minor gaps' — placeholders (CONNECTION_ID, QUERY, actionId) are never shown with realistic values and there is no example of parsing a response, which keeps it below level 5.

4 / 5

Workflow Clarity

The install → login → connection → search → run sequence is present, and the connection state machine (READY / BUILDING / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) gives explicit checkpoints with a poll-again feedback loop. However, 'skip to **Step 2**' references a step that is never labeled (no steps are numbered), and there is no validation or error-handling guidance after running an action. This matches 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit' rather than level 4, whose clear navigation is broken by the dangling step references.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent) and nothing is offloaded: ~140 lines are fully inline, including the proxy flag options table and the detailed clientAction state-machine documentation that belong in a reference file. Section headers provide decent structure, so this is above level 2, but it matches 'Some structure but could be better organized... content that should be separate is inline' — the 'Popular actions' heading even duplicates the earlier 'Searching for actions' guidance.

3 / 5

Total

13

/

20

Passed

Description

61%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 has an explicit 'Use when...' trigger and names a distinct, well-scoped domain, but its capability statement is generic ('Manage data, records, and automate workflows') and trigger coverage omits natural variations like 'Revit', 'BIM', or '.rvt files'. Overall it is serviceable but sits below the strong examples in both specificity and trigger richness.

Suggestions

Replace the generic capability verbs with concrete Revit operations, e.g. 'Query and update Revit models: list elements, read and set parameters, manage views and worksets, run actions against building data.'

Add natural trigger variations and file extensions to the 'Use when' clause, e.g. 'Use when the user mentions Revit, Autodesk Revit, BIM models, .rvt files, or wants to query/modify building data.'

State the mechanism concretely (via the Membrane CLI) so the 'what' answers what will actually be done, not just the abstract outcome.

DimensionReasoningScore

Specificity

The description names the domain ('Autodesk Revit integration') but its actions are generic — 'Manage data, records, and automate workflows' and 'interact with Autodesk Revit data' contain no concrete operations (e.g. list elements, update parameters, extract schedules). This matches the anchor 'Names the domain but actions are minimal or generic'; it is above level 1 because the domain is clearly identified, but below level 3 because no action is concrete.

2 / 5

Completeness

Both parts are present: the 'what' ('Manage data, records, and automate workflows') and an explicit 'when' ('Use when the user wants to interact with Autodesk Revit data'). It falls short of level 5 because the trigger clause is broad and lacks concrete trigger phrases, and the 'what' is generic.

4 / 5

Trigger Term Quality

'Autodesk Revit' is a keyword users would naturally say, but coverage stops there — no synonyms or variations such as 'Revit', 'BIM', 'building model', or '.rvt files' appear. This matches the anchor 'Some relevant keywords but missing common variations or synonyms' rather than level 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

'Autodesk Revit' is a clear niche with a distinct trigger ('interact with Autodesk Revit data') that is unlikely to fire for other skills. This matches the anchor 'Clear niche with distinct triggers; minimal conflict risk'.

5 / 5

Total

14

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

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/autodesk-revit/SKILL.md

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.