CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

resources

MUST use when managing resources.

Quality

55%

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 ./system_prompts/auto-generated/skills/resources/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 strong, dense reference: exact syntax, correct-vs-wrong examples, ordering constraints, and safety gates around secrets and destructive deployment make it highly actionable. Its weaknesses are token cost from the repetitive resource-type catalog, missing post-deploy verification steps, and inlining ~90 lines of type examples that belong in a separate reference file.

Suggestions

Move the 'Common Resource Types' catalog to a references/ file (e.g. references/resource-types.md) and keep one or two exemplars inline with a clearly signaled pointer.

Add a validation step after destructive operations, e.g. run a test script or 'wmill script run ... --args' that consumes the deployed resource to verify the $res:/​$var: references resolve under the run-as identity.

Trim the TypeScript/Python 'Using Resources in Scripts' sections to the function signatures (e.g. 'main(db: RT.Postgresql)') and drop the field-by-field TypedDict boilerplate.

DimensionReasoningScore

Conciseness

The body is dense and free of concept re-teaching (no 'what is PostgreSQL' padding), but the eight-example 'Common Resource Types' catalog (~90 lines: PostgreSQL, MySQL, Slack, S3, HTTP, Kafka, NATS, MQTT) and the TypeScript/Python boilerplate sections restate a single pattern repetitively. This fits anchor 3 ('Mostly efficient but includes some unnecessary explanation or could be tightened'). Not a 4 because the repetition is more than minor trimming; not a 2 because there is no fluffy prose and most sections earn their tokens.

3 / 5

Actionability

Fully executable throughout: exact file patterns ('{path}.resource.json'), copy-paste-ready JSON structures, precise $var:/$res: reference formats, exact resolver limits ('nested at most two levels deep... at most 1000 items'), three explicit wrong examples for run arguments, and concrete CLI commands including 'wmill variable add'. Matches anchor 5 ('Fully executable; copy-paste ready code or commands; specific examples cover the common cases').

5 / 5

Workflow Clarity

Sequencing constraints are stated where they matter ('create or deploy the variable before the resource') and the destructive 'wmill sync push' is gated on explicit user request, but there are no validation/verification steps after destructive or deployment operations (e.g., verify the deployed resource resolves under the run-as identity). Per the judging guideline capping workflow clarity at 3 for destructive operations without validation, this fits anchor 3 ('sequence present but checkpoints missing or implicit').

3 / 5

Progressive Disclosure

Sections are well-organized with clear headers and no buried references, but the skill is a single ~300-line file with no bundle files, inlining a resource-type catalog and script-usage boilerplate that clearly belong in a separate reference file — matching anchor 3 ('content that should be separate is inline'). Not a 4, because there is no split at all and the 50-line simple-skill exception does not apply; not a 2, because the structure is good, not minimal.

3 / 5

Total

14

/

20

Passed

Description

23%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 is a bare trigger clause: it states when to invoke the skill but never says what the skill does, lists no concrete actions, and offers only one generic keyword. It functions as a routing hint rather than a discoverable description and would be nearly indistinguishable from a generic 'resource management' skill.

Suggestions

Add a 'what' clause with concrete actions, e.g. 'Create and manage Windmill resource files ({path}.resource.json), reference secrets via $var:, pass resources as run arguments with $res:<path>, and define custom resource types.'

Include natural trigger terms users would actually say: credentials, connections, resource types, secrets, and named services (PostgreSQL, Slack, S3, Kafka, MQTT).

Name Windmill explicitly and mention the .resource.json file pattern to distinguish this skill from generic resource/credential management skills and reduce conflict risk.

DimensionReasoningScore

Specificity

The description is only 'MUST use when managing resources.' — it names no concrete action whatsoever, only a trigger. This matches the anchor 'Entirely vague; no concrete actions; pure abstract language' ('Helps with documents'), as the word 'resources' gestures at a domain without describing anything the skill does. Not a 2, because even the anchor-2 example ('Processes PDF files') names a domain plus a minimal action verb, which is absent here.

1 / 5

Completeness

Only the 'when' is present ('when managing resources'); the 'what' — creating .resource.json files, referencing secrets via $var:, passing resources as run arguments, custom resource types — is entirely missing. This is exactly anchor 2 ('only when is present without what', e.g. 'Use when working with documents'). Not a 3, because anchor 3 requires a clear 'what'; not a 1, because a when-clause naming a domain term is present and not extremely vague.

2 / 5

Trigger Term Quality

The single keyword phrase 'managing resources' is generic and misses the natural phrases users would say for this domain: 'credentials', 'connection', 'resource type', 'secrets', 'API keys', or named services (PostgreSQL, Slack, Kafka). This matches anchor 2 ('One or two generic keywords; missing the natural phrases users say', e.g. 'Works with files'). Not a 3, because there is no plural set of relevant keywords — only one bare term with no variations or synonyms.

2 / 5

Distinctiveness Conflict Risk

'Resources' is somewhat specific within a Windmill skill suite, but without the word 'Windmill' or terms like 'credentials'/'resource types', the description could overlap with sibling skills covering variables, secrets, or general connection configuration — and with generic senses of 'resources' (system resources, memory). Matches anchor 3 ('Somewhat specific but could still overlap with similar skills'). Not a 4, because the description does not scope itself to its platform, leaving real overlap risk with closely related skills.

3 / 5

Total

8

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

windmill-labs/windmill

Path

system_prompts/auto-generated/skills/resources/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.