trellis-meta

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

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/elebirds/panoptes --skill trellis-meta-elebirds
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-meta
Source: https://github.com/elebirds/panoptes/tree/main/.opencode/skills/trellis-meta
Command: npx skills add https://github.com/elebirds/panoptes --skill trellis-meta-elebirds

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? After running trellis init, AI assistants often do not know how the generated .trellis/ directory and platform folders (.claude/, .codex/, .cursor/, etc.) fit together, so they edit the wrong files or modify upstream npm packages instead of project-local configuration. ## Core Features & Use Cases - Architecture Reference: Explains the three-layer local Trellis model (workflow, persistence, platform integration) and which generated files are safe to edit. - Customization Routing: Maps user requests like "change the workflow", "agent did not read specs", or "add a skill" to the exact local file to modify. - Use Case: A user says "the implement agent never reads my backend conventions." The AI reads the context-loading reference, checks the task's implement.jsonl, and fixes the sub-agent context hook or agent prelude in the project. ## Quick Start Ask the AI to use the trellis-meta skill to change the Trellis workflow so that task creation is skipped for one-reply questions.

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.

Why does my AI agent not read the task specs or PRD?▼

First run `task.py current --source` and `task.py validate <task>` to confirm the active task and JSONL context are correct. Then determine whether your 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 change behavior?▼

No. All customization targets live inside your project: `.trellis/` files and platform directories like `.claude/` or `.codex/`. Only touch upstream source when explicitly contributing a PR or changing the published package.

Where should I put team-specific coding conventions for AI to follow?▼

Put long-term engineering conventions in `.trellis/spec/` with an index.md per layer, or create a project-local skill in your platform's skills directory. Do not store project-private rules in the public trellis-meta skill.

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, Pi Agent, Kilo, Antigravity, and Windsurf. Which directories exist depends on the `trellis init --<platform>` flags you ran.