CtrlK
BlogDocsLog inGet started
Tessl Logo

trellis-before-dev

Discovers and injects project-specific coding guidelines from .trellis/spec/ before implementation begins. Reads spec indexes, pre-development checklists, and shared thinking guides for the target package. Use when starting a new coding task, before writing any code, switching to a different package, or needing to refresh project conventions and standards.

75

Quality

94%

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

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 tight, well-sequenced instruction skill: every step is actionable with real commands, and the delegation to .trellis/ project files is exactly the right structure. Its only weaknesses are slight framing redundancy and minor gaps that would make the templated cat commands fully self-contained.

Suggestions

Remove the redundant framing sentences (the opening line and the step 6 wrap-up) — the numbered steps and the closing 'mandatory' gate already convey the workflow.

Show a one-line example of the get_context.py --mode packages output so the <package>/<layer> placeholders in the cat commands can be filled in confidently.

Add a brief fallback for when ./.trellis/scripts/get_context.py is missing or fails, e.g. listing .trellis/spec/ directories directly with ls.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no concept explanations, just commands and steps. However, minor filler could be trimmed: the opening "Read the relevant development guidelines before starting your task" and step 6's "Understand the coding standards and patterns you need to follow, then proceed with your development plan" restate what the numbered steps already convey. This sits between anchor 5 (every token earns its place) and anchor 4 (minor instances that could be trimmed), closer to 4.

4 / 5

Actionability

Mostly executable guidance: "python3 ./.trellis/scripts/get_context.py --mode packages" is copy-paste ready, and "cat .trellis/spec/<package>/<layer>/index.md" plus "cat .trellis/spec/guides/index.md" are concrete. Minor gaps keep it below anchor 5: the cat commands require substituting placeholders with no sample of the get_context.py output showing what package/layer values look like, and there is no fallback if the script is absent. It is well above anchor 3 because the commands are real, not pseudocode, and the placeholder use is justified by dynamic discovery.

4 / 5

Workflow Clarity

A clear 6-step numbered sequence from discovery to reading the actual guideline files, with an explicit error-prevention checkpoint in step 4 ("The index is NOT the goal — it points you to the actual guideline files") and a mandatory gate ("This step is mandatory before writing any code"). The skill is read-only (no destructive or batch operations), so validation loops are not required, and as a simple under-50-line single-purpose skill with an unambiguous sequence it matches the top anchor per the simple-skills note.

5 / 5

Progressive Disclosure

The skill has no bundle files (no references/, scripts/, or assets/), and at ~30 lines it needs none — all detailed content appropriately lives in the project's .trellis/ tree, which the skill delegates to with exact paths. Per the rubric's simple-skills guidance, an under-50-line skill with no need for external references scores 5 with well-organized sections, which the numbered step structure provides. It is not score 4 because there is no content that should have been split out and every pointer is one level deep.

5 / 5

Total

18

/

20

Passed

Description

100%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.

This is a strong description: it states concrete actions in third person, names the exact source (.trellis/spec/), and includes an explicit and multi-trigger 'Use when...' clause. It aligns closely with the rubric's good overall examples.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Discovers and injects project-specific coding guidelines from .trellis/spec/", "Reads spec indexes, pre-development checklists, and shared thinking guides for the target package" — with a clearly named domain and comprehensive coverage of what the skill does, matching the top anchor. It is not score 4 because there are no minor gaps: every listed action is specific and the scope is fully covered.

5 / 5

Completeness

It explicitly answers both questions: what it does ("Discovers and injects... Reads spec indexes, pre-development checklists, and shared thinking guides") and when to use it ("Use when starting a new coding task, before writing any code, switching to a different package, or needing to refresh project conventions and standards") with concrete trigger phrases. Not score 4 because the when-clause is fully explicit rather than needing more specificity.

5 / 5

Trigger Term Quality

The when-clause covers natural trigger phrases with synonyms: "starting a new coding task", "before writing any code", "switching to a different package", "needing to refresh project conventions and standards", plus the concrete path ".trellis/spec/". This matches comprehensive natural-term coverage including synonyms; it is not score 4 because no common variation a user would naturally say is clearly missing.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — reading .trellis/spec/ guidelines before development — with distinct triggers tied to that ecosystem, so it is unlikely to fire for unrelated skills. Not score 4 because the .trellis-specific scope leaves only minimal overlap risk with closely related skills.

5 / 5

Total

20

/

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
mindfold-ai/Trellis
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.