CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

64

Quality

80%

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 ./.omp/skills/trellis-meta/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

67%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-architected meta-skill: excellent annotated reference structure, concrete commands and config keys, and strong safety guidance in the Do Not section. Its two real defects are two referenced bundle files that do not exist, and noticeable cross-section repetition of the v0.6 surfaces that inflates token cost without adding guidance.

Suggestions

Add the missing reference files 'references/local-architecture/multi-agent-channel.md' and 'references/local-architecture/bundled-skills.md' to the bundle (or remove their entries from How To Use and References), since both the routing and the reference index currently point to files that are absent.

Trim the redundancy: the channel event log path, bundled .trellis/agents/ definitions, trellis mem sources, and getBundledSkillTemplates() are each stated in the intro paragraph and again in References and/or Current Rules — state each fact once and cross-reference it.

Break the ~180-word single-sentence v0.6 overview paragraph into short bullets (channel runtime / cross-session memory / dual-package release) so the opening section is scannable and cheaper to read.

DimensionReasoningScore

Conciseness

The body is dense and almost entirely Trellis-specific with no filler explanations of concepts Claude already knows, but the same facts are restated across sections: the channel event log path appears three times, '.trellis/agents/{check,implement}.md' in six places, and the trellis mem sources and getBundledSkillTemplates() twice each — the ~180-word v0.6 overview sentence alone re-describes what References and Current Rules repeat. This is more than 'minor instances that could be trimmed', placing it below the efficient anchor.

3 / 5

Actionability

Guidance is highly concrete throughout — executable commands ('task.py create --parent <slug>', 'trellis workflow --template <id>', 'trellis mem list | search | context | extract | projects'), exact config keys (channel.worker_guard.idle_timeout, hooks.after_create), and specific file paths. The gap is that 'references/local-architecture/multi-agent-channel.md' and 'references/local-architecture/bundled-skills.md' are referenced in How To Use and References but absent from the bundle, leaving those navigation steps unexecutable.

4 / 5

Workflow Clarity

The 'How To Use' section gives a clear, conditionally routed 5-step sequence with explicit validation ('Before editing, read the actual files in the user project and treat local content as authoritative' and 'cross-check against the local .trellis/config.yaml and the installed CLI's trellis --help'). It falls short of the top anchor because there are no error-recovery feedback loops and step 3 directs the reader to a reference file that does not exist in the bundle.

4 / 5

Progressive Disclosure

The structure is exemplary — a lean overview body, a routing section, and ~20 one-level-deep references each annotated with a one-line description. Scored against the actual bundle, however, two of the referenced paths (references/local-architecture/multi-agent-channel.md and references/local-architecture/bundled-skills.md) are missing, which breaks navigation for the multi-agent channel and bundled-skills topics and drops it below the clear-and-complete top anchor.

4 / 5

Total

15

/

20

Passed

Description

86%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 'Use when' trigger clause and comprehensive, natural Trellis-specific trigger terms. Its main weakness is that the action verbs are limited to the generic pair 'understand and customize', with specificity carried entirely by the enumerated targets rather than by concrete action statements.

Suggestions

Replace or expand the generic verbs 'Understand and customize' with concrete actions, e.g. 'Modify .trellis workflow, config, tasks, and spec files; edit platform hooks, agents, and skills' so the capability list reads as actions rather than targets.

Consider trimming the long mid-list of generic terms ('hooks, settings, agents, skills, commands, prompts, workflows') to the few users most commonly say, reducing overlap risk with generic platform-config skills while keeping the distinctive Trellis triggers.

DimensionReasoningScore

Specificity

The description names the domain ("local Trellis architecture") and only two concrete actions — "Understand and customize" — while the enumerated targets (.trellis, hooks, agents, skills, trellis channel, trellis mem) are specific, the verbs themselves are generic. It does not list several specific actions, so it sits at the anchor for 'domain plus 1-2 concrete actions' rather than the level above.

3 / 5

Completeness

Both parts are explicit: 'what' is stated concretely ("Understand and customize the local Trellis architecture inside a user project") and 'when' is given by a literal "Use when modifying..." clause enumerating concrete trigger surfaces. This matches the top anchor exactly.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including the directory path (.trellis), CLI command names (trellis channel, trellis mem, trellis init), feature names users would actually say (hooks, settings, agents, skills, commands, prompts, workflows, workflow templates, spec refresh), and bundled skill names. These are the exact phrases a Trellis user would naturally say when needing this skill.

5 / 5

Distinctiveness Conflict Risk

The description is anchored to a clear Trellis niche with distinct triggers (trellis channel, trellis mem, .trellis/agents), but the mid-list generic terms 'hooks, settings, agents, skills, commands, prompts, workflows' overlap with generic platform-configuration skills, creating minor wrong-skill trigger risk — mostly distinct rather than fully minimal-risk.

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: 3 missing, 27 deeper-than-1-level

Warning

Total

15

/

16

Passed

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.