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

84%

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

78%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-structured, information-dense skill body that treats the context window seriously and routes detail to an excellent, verified one-level-deep reference bundle. The main gaps are minor: duplicated warnings, one overloaded paragraph, no worked edit example, and no explicit error-recovery loop in the workflow.

Suggestions

Deduplicate the npm/node_modules warning: it appears both in prose ("Do not default to modifying the global npm install directory or node_modules") and in the Do Not section ("Do not modify the global npm install directory or node_modules/@mindfoldhq/trellis..."); keep only the Do Not version and tighten the prose paragraph accordingly.

Split the overloaded v0.6 paragraph into three short labeled items (channel runtime, cross-session memory, dual-package release) so each surface is scannable instead of buried in one long sentence.

Add one small worked example for a common customization (e.g. a before/after snippet of adding a hooks.after_finish entry to .trellis/config.yaml) to lift actionability from specific-but-abstract to copy-paste ready.

DimensionReasoningScore

Conciseness

The body is dense with Trellis-specific facts Claude cannot know (paths, commands, config keys) and never pads with explanations of known concepts. Minor tightening is possible: the "do not default to the global npm install directory" warning appears in both prose (line 20) and the Do Not section (line 80), and the v0.6 paragraph packs three architectural surfaces into one overloaded sentence — matching 'efficient; minor instances that could be trimmed' rather than the fully lean level-5 anchor.

4 / 5

Actionability

Concrete, executable commands appear throughout: "trellis workflow --template <id>", "task.py create --parent <slug>", "trellis channel spawn --agent <name>", "trellis mem list | search | context | extract", plus exact file paths and config keys (channel.worker_guard.idle_timeout, codex.dispatch_mode: inline | sub-agent). For an instruction-only skill the guidance is specific and actionable, but it stops short of copy-paste-ready edit examples for the common customization cases, keeping it just below the fully executable level-5 anchor.

4 / 5

Workflow Clarity

The "How To Use" section gives a clear 5-step conditional routing sequence (overview first, then platform-specific, multi-agent, or customization references), ending with a validation gate ("read the actual files in the user project and treat local content as authoritative"). Additional checkpoints exist (check .trellis/.template-hashes.json before overwrites; cross-check trellis --help before claiming a knob exists), but there is no explicit error-recovery/feedback loop for when a step fails, which fits 'clear sequence with most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

The body is a well-organized overview: a guided reading order, an annotated index of 23 one-level-deep reference files (all verified to exist under references/local-architecture/, references/platform-files/, and references/customize-local/), grouped by topic with one-line descriptions, plus concise current-rules and do-not sections. This matches the level-5 anchor of a clear overview with well-signaled one-level-deep references and easy navigation.

5 / 5

Total

17

/

20

Passed

Description

83%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 with an explicit and detailed 'Use when...' trigger clause, a clear what-statement, and rich Trellis-specific trigger vocabulary. Its main weaknesses are a thin action-verb vocabulary (understand/modify) and some generic platform nouns that slightly broaden conflict risk.

DimensionReasoningScore

Specificity

"Understand and customize the local Trellis architecture" gives two concrete verbs applied to an exhaustive, specific enumeration of targets ("modifying .trellis plus platform hooks, settings, agents, skills, commands, prompts, workflows, the channel runtime (trellis channel), bundled runtime agents under .trellis/agents/..."). Coverage of surfaces is comprehensive but the action vocabulary itself is thin (only understand/modify), which keeps it just below the level-5 anchor of multiple specific concrete actions.

4 / 5

Completeness

Explicitly answers both questions: what ("Understand and customize the local Trellis architecture inside a user project") and when ("Use when modifying .trellis plus platform hooks, settings, agents, skills, commands, prompts, workflows..."). The 'when' clause is explicit, detailed, and lists concrete trigger surfaces, matching the level-5 anchor exactly; the missing-'Use when' cap does not apply.

5 / 5

Trigger Term Quality

Strong natural keywords a Trellis user would say: ".trellis", "trellis channel", "trellis mem", "trellis init", "hooks", "settings", "agents", "workflow templates". A few natural phrasings are missing (e.g. "customize Trellis", "trellis config", specific platform directory names like .claude/.codex), so it sits between good (4) and comprehensive (5) keyword coverage.

4 / 5

Distinctiveness Conflict Risk

Trellis-specific anchors (.trellis, trellis channel, trellis mem, bundled skills) give it a clear niche with minimal conflict against unrelated skills. However, generic trigger nouns like "platform hooks, settings, agents, skills, commands, prompts, workflows" create minor overlap risk with a generic platform-configuration skill, so it fits 'mostly distinct; minor overlap risk' rather than the level-5 anchor.

4 / 5

Total

17

/

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

packages/cli/src/templates/common/bundled-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.