skills.rest
ZipperCode
ZipperCodeCOMMUNITY
Explore all skills by this author →
GitHub

trellis-meta

Guides customization of local Trellis workflow, hooks, agents, and platform files.

4|1|Updated Apr 29, 2026
Search Tags:#task management#hooks#ai agents#context injection#developer tooling#trellis#workflow customization
One-click install
npx skills add https://github.com/ZipperCode/lingma2api --skill trellis-meta-zippercode
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-meta
Source: https://github.com/ZipperCode/lingma2api/tree/main/.opencode/skills/trellis-meta
Command: npx skills add https://github.com/ZipperCode/lingma2api --skill trellis-meta-zippercode

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? After running trellis init, teams often need to adapt the generated Trellis setup to their own workflow, but it is unclear which files are safe to edit and how the pieces connect. This Skill explains the local Trellis architecture and directs AI agents to the correct customization entry points inside a user project. ## Core Features & Use Cases - Architecture Reference: Documents the three-layer local Trellis model covering .trellis/workflow.md, tasks, specs, workspace memory, and context injection. - Platform File Map: Maps hooks, settings, agents, skills, and commands across platforms such as Claude Code, Cursor, Codex, OpenCode, Kiro, and Gemini CLI. - Customization Guides: Provides step-by-step references for changing workflow phases, task lifecycle hooks, context loading, agents, skills, and spec structure. - Use Case: A user asks to make the check agent run project-specific lint commands; the Skill directs the AI to edit the platform's trellis-check agent file and update .trellis/spec/ rather than upstream Trellis source. ## Quick Start Ask the AI to customize your project's Trellis setup, for example: change the workflow so tasks can be skipped for one-reply questions, and it will read the local .trellis/ files and edit the right ones.

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, skill routing, and workflow-state prompt blocks. After editing, check that platform entry files like skills and commands still describe the same flow.

How do I change trellis-implement or trellis-check agent behavior?▼

Edit the platform-specific agent files in your project, such as `.claude/agents/trellis-*.md` or `.codex/agents/trellis-*.toml`. Keep role boundaries intact, specify read order starting from the active task PRD, and define explicit write boundaries.

Which platforms does Trellis support for hooks and agents?▼

Trellis generates files for Claude Code, Cursor, OpenCode, Codex, Kiro, Gemini CLI, Qoder, CodeBuddy, GitHub Copilot, Factory Droid, and Pi Agent. Main-session platforms like Kilo, Antigravity, and Windsurf rely on workflows and skills instead of sub-agents.

Why does my AI agent not read the current task context?▼

First run `python3 ./.trellis/scripts/task.py current --source` and validate the task JSONL files. Then check whether the platform uses hook push (edit the inject-subagent-context hook) or agent pull (edit the agent file's read steps).

Where should I put team coding conventions in a Trellis project?▼

Put long-term engineering conventions in `.trellis/spec/` under the appropriate layer with an index.md entry point. For project-specific AI capabilities, create a project-local skill rather than editing the public trellis-meta skill.

Should I edit node_modules or the Trellis npm package to customize behavior?▼

No. Customization should target generated files inside your project: `.trellis/` and platform directories. Only modify upstream Trellis source when explicitly contributing a PR or changing the npm package itself.

Related Skills

Explore More Software Engineering Skills→
EcoPasteHubEcoPasteHub
7.3k

trellis-meta

Guides AI agents in understanding and customizing local Trellis architecture within user projects.

Official
Advanced
BaSui01BaSui01
3

start

Loads Trellis workflows and Git status to initialize AI-assisted coding sessions.

Community
Advanced
yizhitangtongxueyizhitangtongxue

record-session

Records work sessions and archives completed tasks in Trellis project journals.

Community
Intermediate
21ess21ess

trellis-meta

Guide customization of local .trellis architecture and platform directories.

Community
Intermediate