CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

assembled

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

Quality

61%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/assembled/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 solid, command-first integration guide: install, auth (including headless flow), connection lifecycle with state handling, action discovery/execution, and a proxy fallback are all covered with executable commands. Main weaknesses are mild padding, a broken 'Step 2' cross-reference and unlabeled step numbering, and a 'Popular actions' section that doesn't list any actions.

Suggestions

Remove the empty-calorie lines ('Use action names and parameters as needed', the vague 'Agent Types' note) and tighten the Membrane prose in 'Best practices' to cut tokens without losing guidance.

Fix the workflow numbering: label 'Step 1'/'Step 2' explicitly (or drop the 'skip to Step 2' / '1b' labels) so the connection → action-execution handoff is unambiguous.

Either populate 'Popular actions' with 3-5 named example actions (e.g. listing projects, scheduling an agent) or merge it into the 'Searching for actions' section instead of repeating the discovery command.

DimensionReasoningScore

Conciseness

The body is largely command-driven and practical, but includes fluff Claude does not need: the vacuous line 'Use action names and parameters as needed', the vague and ungrammatical 'Agent Types' note ('Those will be used to adjust tooling to be used best with your harness'), and editorial padding like 'so you can focus on the integration logic rather than auth plumbing'. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation that could be tightened') rather than 4, whose over-explanation is only minor.

3 / 5

Actionability

Concrete, executable CLI commands appear throughout with placeholders and a flags table (install, login, connection ensure, action list/run, request proxy), e.g. 'membrane action run <actionId> --connectionId=CONNECTION_ID --input {...} --json'. Minor gaps keep it below 5: the 'Step 2' referenced in 'skip to Step 2' does not exist, the intent example is the placeholder 'QUERY' with no worked example, and 'Popular actions' promises a list but only repeats the discovery command.

4 / 5

Workflow Clarity

The flow (install → login → connection ensure → poll state → handle clientAction → search actions → run/proxy) is clearly sequenced with explicit checkpoints and a feedback loop: poll with --wait, branch on READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR, re-poll after user action, check the error field. Not 5 because the step numbering is broken — 'Step 1' and 'Step 2' are referenced but never labeled (only '1b' exists), leaving the reader to guess where the connection phase ends and action execution begins.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so the skill is a single self-contained file with well-organized sections, clear headers, and one-level navigation — good structure with most content appropriately placed (anchor 4). It falls short of 5 only because material like the proxy flags table and connection-state details could live in a reference file if the skill grows, and 'Assembled Overview' bullets ('Project — Task — Attachment') carry no navigational value.

4 / 5

Total

15

/

20

Passed

Description

37%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 correctly uses third person and includes an explicit 'Use when...' clause, but it is thin: it names the Assembled domain without conveying any concrete capability or the platform's purpose. The generic action list ('manage data, records, and automate workflows') weakens trigger matching and creates overlap risk with other data-integration skills.

Suggestions

Enumerate concrete Assembled capabilities in the description, e.g. 'Forecast staffing needs, schedule support agents, and monitor real-time support performance in Assembled.'

Expand trigger terms to natural user phrasing such as 'support scheduling', 'staffing forecast', 'agent shifts', or 'workforce management (WFM)' so the skill fires when users describe those tasks without naming the product.

State the platform's identity (workforce management for customer support) so the description is distinguishable from generic data/records integration skills.

DimensionReasoningScore

Specificity

The description names the domain ('Assembled integration') but its actions are generic: 'Manage data, records, and automate workflows' could describe nearly any integration and lists no concrete Assembled capabilities (e.g., forecasting, scheduling, agent management). It matches anchor 2 ('Names the domain but actions are minimal or generic') better than 3, which requires 1-2 concrete actions.

2 / 5

Completeness

It does have an explicit 'when' clause ('Use when the user wants to interact with Assembled data'), so it avoids the missing-trigger cap of 3, but the 'what' is vague ('Manage data, records, and automate workflows'), placing it at anchor 3 rather than 4 — anchor 4 expects both a reasonably concrete 'what' and a 'when'.

3 / 5

Trigger Term Quality

The only substantive keyword is the product name 'Assembled'; 'data', 'records', and 'workflows' are generic. Common natural phrases a support-ops user would say — scheduling, forecasts, staffing, WFM, support tickets — are entirely absent, matching anchor 2 ('one or two generic keywords; missing the natural phrases users say').

2 / 5

Distinctiveness Conflict Risk

'Assembled' is a distinctive product name and the trigger is tied to it, but the description never states what Assembled is (workforce management for support teams), and the generic 'manage data, records, automate workflows' framing overlaps with any data/records integration skill — 'somewhat specific but could still overlap with similar skills' (anchor 3), not 4's 'minor overlap risk'.

3 / 5

Total

10

/

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/assembled/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.