CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

trellis-meta

Understand and customize the local Trellis architecture inside a user project. Use when modifying .trellis plus platform hooks, settings, agents, skills, commands, prompts, workflows, the channel runtime (trellis channel), bundled runtime agents under .trellis/agents/, selectable workflow templates, registry-backed spec refresh, cross-session memory (trellis mem) generated by trellis init, or AI-facing bundled skills (trellis-channel, trellis-session-insight, trellis-spec-bootstrap) and bundled-skill auto-dispatch flow.

Quality

87%

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

The canonical home for this skill is trellis-meta in mindfold-ai/Trellis

SKILL.md
Quality
Evals
Security

Quality

Content

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

A dense, highly actionable meta-skill with excellent reference navigation and concrete commands, paths, and config keys throughout. Its weaknesses are moderate cross-section redundancy and a bundle containing stale/unreferenced directories that SKILL.md navigation never surfaces.

Suggestions

Deduplicate the v0.6 surface descriptions: the opening paragraph, References descriptions, and Current Rules repeat the same facts about workflow templates, the channel runtime, and trellis mem; state each once and let the reference file carry detail.

Remove or fold in the orphaned reference directories (claude-code/, core/, how-to-modify/, meta/) that no SKILL.md path reaches — how-to-modify/ duplicates customize-local/ from a pre-v0.6 layout and risks an AI reading stale guidance.

Make the error-recovery path explicit for template conflicts: spell out the full validate loop (check `.trellis/.template-hashes.json` → detect 'modified by user' conflict → write `.new` sidecar instead of overwriting).

DimensionReasoningScore

Conciseness

The body is dense and fact-per-line (Current Rules bullets give exact paths, config keys, and commands) with almost no explanation of concepts Claude already knows. Not 5 because there is notable redundancy: the v0.6 surfaces (workflow templates, channel runtime, trellis mem, bundled agents) are described in the opening paragraph and again across the References and Current Rules sections.

4 / 5

Actionability

Copy-paste-ready commands appear throughout (`trellis channel spawn --agent <name>`, `task.py create --parent <slug>`, `trellis workflow --template <id>`, `trellis mem list | search | context | extract | projects`) alongside exact config keys (`channel.worker_guard.idle_timeout`, `registry.spec.source`) and exact file paths. As an instruction-only skill the guidance is fully executable and covers the common cases.

5 / 5

Workflow Clarity

"How To Use" gives a clear sequenced navigation workflow with conditional branching and a pre-edit checkpoint ("Before editing, read the actual files in the user project and treat local content as authoritative"), plus a cross-check rule ("cross-check against the local `.trellis/config.yaml` and the installed CLI's `trellis --help` before claiming a knob exists"). Not 5 because error-recovery feedback loops are implicit — e.g., what to do when `.trellis/.template-hashes.json` reports user-modified conflicts is only partially covered by the `.new` sidecar rule.

4 / 5

Progressive Disclosure

All 23 referenced files exist, are one level deep, grouped into three clear sections, and each carries a one-line description — strong overview navigation. However, 17 of the 40 bundle files under references/ (claude-code/, core/, how-to-modify/, meta/) are not reachable from any navigation in SKILL.md, and how-to-modify/ appears to be a stale pre-v0.6 duplicate of customize-local/, which is a real organization gap that keeps this below anchor 5.

4 / 5

Total

17

/

20

Passed

Description

87%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 answers both what and when with Trellis-specific trigger terms and near-comprehensive surface coverage. Its main weaknesses are coarse action verbs and a keyword list padded with internal jargon that no user would naturally say.

Suggestions

Trim internal-jargon triggers (e.g., "bundled-skill auto-dispatch flow", "registry-backed spec refresh") and add natural user synonyms like "change", "edit", or "configure" to the when-clause.

Replace the generic verb pair "Understand and customize" with more concrete operations (e.g., "Customize workflow phases, hooks, agent behavior, and channel runtime") to sharpen the action list.

DimensionReasoningScore

Specificity

Actions are limited to two generic verbs ("Understand and customize"), but the targets are specific and comprehensive (`.trellis`, `.trellis/agents/`, `trellis channel`, `trellis mem`, `trellis init`, named bundled skills). Matches anchor 4 (several specific targets, minor coverage gaps) rather than 3 because the surface coverage is thorough, and not 5 because the operations themselves are not distinct concrete actions like 'extract' or 'merge'.

4 / 5

Completeness

Clear what ("Understand and customize the local Trellis architecture inside a user project") plus an explicit, itemized when-clause ("Use when modifying .trellis plus platform hooks, settings, agents, skills, commands, prompts, workflows, ...") with concrete trigger phrases. Matches the anchor-5 example pattern exactly; not 4 because the when-clause is explicit rather than merely present.

5 / 5

Trigger Term Quality

Good natural-term coverage: "Trellis", ".trellis", "hooks", "settings", "agents", "skills", "commands", "prompts", "workflows", "workflow templates", "cross-session memory". Not 5 because phrases like "bundled-skill auto-dispatch flow" and "registry-backed spec refresh" are internal jargon users would not naturally say, and simple synonyms ("change", "edit", "configure") are absent.

4 / 5

Distinctiveness Conflict Risk

Distinct Trellis-anchored triggers ("trellis channel", "trellis mem", ".trellis/agents/", named bundled skills trellis-channel/trellis-session-insight/trellis-spec-bootstrap) define a clear niche with minimal conflict risk. The generic middle terms (hooks, settings, agents) are all scoped under Trellis modification, so it does not fall to anchor 4.

5 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 27 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

mindfold-ai/Trellis

Path

.agents/skills/trellis-meta/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.