trellis-meta

Guides AI agents in understanding and customizing local Trellis project architecture.

Updated Sep 5, 2026
One-click install
npx skills add https://github.com/jiozhaoyue/ST-BgLoader --skill trellis-meta-jiozhaoyue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-meta
Source: https://github.com/jiozhaoyue/ST-BgLoader/tree/main/.cursor/skills/trellis-meta
Command: npx skills add https://github.com/jiozhaoyue/ST-BgLoader --skill trellis-meta-jiozhaoyue

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? After running trellis init, a project contains a layered Trellis system (.trellis/ workflow, tasks, specs, scripts, plus platform directories like .claude/, .codex/, .cursor/) that AI assistants often misunderstand or edit in the wrong place. This Skill teaches an AI the local Trellis architecture, operating model, and correct customization entry points so changes land in the right files without breaking update-managed templates. ## Core Features & Use Cases - Architecture Orientation: Explains the workflow, persistence, platform integration, and channel runtime layers, including .trellis/workflow.md, config.yaml, tasks, specs, workspace journals, and trellis mem cross-session recall. - Customization Routing: Maps user requests (change phases, hooks, agents, skills, spec structure, task lifecycle) to the exact local files to edit, with per-platform path tables for 21 supported AI tools. - Bundled Skill Governance: Documents how bundled skills are auto-dispatched, how .template-hashes.json protects user edits, and where project-private conventions belong. - Use Case: A user asks to make the check agent run a project-specific lint command; the AI reads this Skill, identifies the platform's trellis-check agent file as the edit target, and avoids touching upstream npm packages or bundled skill directories. ## Quick Start Ask the AI to use the trellis-meta skill to explain how to customize the Trellis workflow or agent behavior in this project.

Frequently Asked Questions about trellis-meta

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I customize the Trellis workflow in my project?▼

Edit `.trellis/workflow.md`, which is the local workflow source of truth defining phases, routing, and workflow-state blocks. After editing, check that platform entry files (skills, commands) still describe the same flow.

Where should I put team-specific coding conventions for Trellis?▼

Put project-private rules in `.trellis/spec/` or a project-local skill, never inside bundled skills like trellis-meta. Bundled skill directories are refreshed by `trellis update` and local edits there will be flagged or overwritten.

Does editing .claude/agents/trellis-implement.md change channel runtime workers?▼

No. Channel runtime workers load platform-agnostic role cards from `.trellis/agents/<name>.md`. Per-platform agent files like `.claude/agents/trellis-implement.md` only affect direct sub-agent dispatch from the main session.

Why did trellis update flag my skill file as modified by user?▼

Trellis records template hashes in `.trellis/.template-hashes.json` for every file it generates. When local content diverges from the recorded hash, update detects the modification and prompts you to keep, overwrite, or create a `.new` sidecar file.

Can I disable bundled Trellis skills in my project?▼

There is no per-project opt-out flag. You can delete the skill directory in each platform skill root, and `trellis update` will treat the deletion as a user modification, or pin an older CLI version that did not ship the skill.