trellis-meta

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

2|Updated Jun 2, 2026
One-click install
npx skills add https://github.com/42team-ru/teampilot --skill trellis-meta-42team-ru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trellis-meta
Source: https://github.com/42team-ru/teampilot/tree/main/.cursor/skills/trellis-meta
Command: npx skills add https://github.com/42team-ru/teampilot --skill trellis-meta-42team-ru

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? After running trellis init, a project contains many generated files across .trellis/ and platform directories like .claude/, .cursor/, and .codex/. This Skill helps an AI understand that local Trellis architecture and modify the correct files when you want to change workflows, hooks, agents, skills, commands, or specs—without touching upstream source code or node_modules. ## Core Features & Use Cases - Architecture Guidance: Explains the three-layer local Trellis model (workflow, persistence, platform integration) and which files are safe to edit. - Platform File Map: Documents where skills, agents, hooks, and settings live for Claude Code, Cursor, Codex, Kiro, Gemini CLI, and other platforms. - Customization Playbooks: Step-by-step references for changing workflow phases, task lifecycle hooks, context injection, agent behavior, spec structure, and project-local conventions. - Use Case: You want the check agent to run a project-specific lint command. The Skill directs you to the platform's trellis-check agent file and explains how to keep .trellis/workflow.md in sync. ## Quick Start Ask the AI to change the Trellis workflow so that task creation is skipped for one-reply questions, and have it update the relevant files 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. Change phase descriptions, skill routing, or `[workflow-state:STATUS]` blocks, then 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 agent file in your project, such as `.claude/agents/trellis-implement.md` or `.cursor/agents/trellis-check.md`. Keep responsibilities single-purpose, specify read order starting from the active task PRD, and define explicit write boundaries.

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

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

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

Run `python3 ./.trellis/scripts/task.py current --source` and `task.py validate <task>` to confirm the task and JSONL context are correct. Then check whether the platform uses hook push (edit the inject-subagent-context hook) or agent pull (edit the agent file's read steps).

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

No. Default to modifying generated files inside your project: `.trellis/` and platform directories. Only work on upstream Trellis source when you explicitly want to contribute a PR, fork the CLI, or change npm package contents.