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

88%

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

86%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 well-engineered meta-skill body: dense with tool-specific facts, concrete commands and exact paths, a conditional reading workflow, real guardrails against destructive overwrites, and a references section that maps 1:1 onto the actual bundle with one-level-deep navigation. The weaknesses are minor: some duplication between the intro and Do Not sections, and validation guidance that could be consolidated into an explicit pre-edit checklist.

Suggestions

State the lockstep dual-package rule once (Do Not section) and reference it from the intro instead of repeating it nearly verbatim, saving tokens.

Consolidate the pre-edit safety checks (template-hashes, .new sidecars, trellis --help cross-check) into one explicit ordered checklist in How To Use to add a clear validation checkpoint.

Trim the inline platform-directory enumeration in the scope list to the top few examples and defer the full list to references/platform-files/platform-map.md, which already covers it.

DimensionReasoningScore

Conciseness

The body is dense with Trellis-specific facts Claude could not know (config keys like 'channel.worker_guard.idle_timeout', archive-slug collision rules, lockstep dual-package releases) — no padding explaining generic concepts, so it is well above anchors 2-3. It falls short of anchor 5 because of minor repetition and bloat: the lockstep-package rule appears twice ('both @mindfoldhq/trellis and @mindfoldhq/trellis-core ship as published packages sharing one version' at the top and again nearly verbatim in Do Not), and the platform-directory enumeration in the scope list is a long inline run-on that could be delegated to platform-map.md.

4 / 5

Actionability

Fully concrete, copy-paste-ready guidance throughout: exact commands ('task.py create --parent <slug>', 'task.py add-subtask <parent> <child>', 'task.py list-context <task>', 'trellis channel spawn --agent <name>', 'trellis workflow --template <id>', 'trellis mem list | search | context | extract | projects'), exact file paths ('~/.trellis/channels/<project>/<channel>/events.jsonl', '.trellis/.template-hashes.json'), and exact config keys ('hooks.after_create / after_start / after_finish / after_archive', 'codex.dispatch_mode: inline | sub-agent'). This is an instruction/config skill and the guidance is fully actionable, matching anchor 5.

5 / 5

Workflow Clarity

The 'How To Use' section gives a clear conditional 5-step sequence (read overview first, branch by request type, then 'Before editing, read the actual files in the user project and treat local content as authoritative'), and the Do Not section supplies real guardrails: 'check .trellis/.template-hashes.json first and prefer .new sidecar files over destructive overwrites' and 'cross-check against the local .trellis/config.yaml and the installed CLI's trellis --help before claiming a knob exists'. It stops short of anchor 5 because there is no explicit validate-then-retry feedback loop and the pre-edit checklist is spread across sections rather than consolidated as a checklist.

4 / 5

Progressive Disclosure

Exemplary structure: the SKILL.md is an overview with a guided reading order ('Read references/local-architecture/overview.md first'), and every one of the 23 cited reference files exists in the bundle and is one level deep — no nested references. Each reference carries a one-line description ('references/local-architecture/multi-agent-channel.md: trellis channel subcommands, project-scoped event store, forum/thread channels...'), grouped under three clear headings. This matches anchor 5 (clear overview with well-signaled one-level-deep references, easy navigation).

5 / 5

Total

18

/

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.

A strong description: it states what the skill does and gives an explicit, detailed 'Use when modifying...' trigger clause covering the tool's main surfaces. Its main weakness is that the verb coverage is thin ('understand', 'customize') — the specificity comes from the enumerated objects rather than distinct actions — and the long parenthetical chains make it read as dense jargon in places.

Suggestions

Lead with 2-3 more distinct concrete verbs (e.g., 'Inspect, modify, and re-configure...') so the actions themselves, not just the enumerated objects, carry the specificity.

Trim the nested parentheticals (e.g., fold 'generated by trellis init' and the bundled-skill name list into a tighter trigger list) so natural trigger phrases stand out.

Add a few plain-language trigger synonyms users would actually type, such as 'customize Trellis behavior' or 'change the workflow', to broaden natural-term coverage.

DimensionReasoningScore

Specificity

The description opens with two somewhat generic verbs ("Understand and customize the local Trellis architecture") but then enumerates a long list of concrete objects: ".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)". This matches anchor 4 (several specific actions, minor gaps) rather than anchor 5, because the actions themselves remain only 'understand' and 'customize' rather than multiple distinct concrete actions like 'extract', 'fill', 'merge'.

4 / 5

Completeness

It explicitly answers 'what' ("Understand and customize the local Trellis architecture inside a user project") and 'when' with a concrete "Use when modifying .trellis plus platform hooks, settings, agents, skills, commands, prompts, workflows..." clause enumerating concrete trigger scenarios. This matches the anchor 5 example pattern (what + explicit 'Use when' with concrete triggers); it is not a 4 because the 'when' clause is explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

Good natural-keyword coverage: users would plausibly say "modify .trellis", "platform hooks", "settings", "agents", "skills", "commands", "workflow templates", "trellis channel", "trellis mem", and the bundled skill names (trellis-channel, trellis-session-insight, trellis-spec-bootstrap). It sits at anchor 4 rather than 5 because a few natural variations are missing (e.g., 'customize', 'change behavior', 'trellis init output', plain 'Trellis' as a trigger) and the density of parenthetical jargon slightly dilutes the natural phrasing.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche: meta-customization of a specific local tool's architecture, with distinctive triggers ('.trellis', 'trellis channel', 'trellis mem', 'trellis init', named bundled skills) unlikely to fire for unrelated skills. It clearly matches anchor 5 (clear niche with distinct triggers, minimal conflict risk); anchor 4 would require some overlap with closely related skills, which is not evident here.

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

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