trellis-channel
Use Trellis channel for live multi-agent collaboration, spawned workers, cross-agent review, progress inspection, forum channels, and channel log debugging.
Install / Use
npx skills add fy-agent/fyagent --skill trellis-channelInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of trellis-channel
trellis-channel scores 85/100 on our quality scale, 2661st of 4,698 Development & Engineering skills we index.
Its SKILL.md is 4.7 KB long, split into 6 sections with 2 code examples: a solid amount of guidance for an agent.
With 1,181 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so trellis-channel is actively maintained.
- Our last check on 2026-11-05 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
trellis-channel compared with similar skills
All 4 of these similar skills score higher than trellis-channel; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| trellis-channel (this skill)by fy-agent | 85 | 1.2k | 55d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install trellis-channel?
- Run
npx skills add fy-agent/fyagent --skill trellis-channel. The install tabs above show the steps for each supported agent. - Which AI agents does trellis-channel work with?
- It is written for Claude Code and OpenAI Codex, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is trellis-channel safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is trellis-channel still maintained?
- The repository was last updated about 2 months ago, so trellis-channel is actively maintained.
Skill content
View source on GitHubname: trellis-channel description: Use Trellis channel for live multi-agent collaboration, spawned workers, cross-agent review, progress inspection, forum channels, and channel log debugging.
trellis-channel
trellis channel is the local multi-agent collaboration runtime. Reach for it when agents need to talk through a durable event log, when a worker should be spawned as a peer process, when an in-flight worker needs interrupt / debugging, or when feedback should be recorded on a durable --type forum channel.
Typical user signals: "和 codex/claude 讨论", "brainstorm with another agent", "spawn an implement/check worker", "let agent review", "open an issue board / changelog forum", "look at this thread", "channel is stuck / no output", "progress was truncated", "how do I write that channel command".
This skill is an index. Load only the reference file for the current job — do not preload all of them.
First Commands
trellis --version
trellis channel --help
trellis channel list --all
trellis channel list --scope global --all
If the user names a channel or thread, inspect it before asking for background:
trellis channel forum <board> --scope global
trellis channel thread <board> <thread> --scope global
trellis channel context list <board> --scope global --thread <thread>
Route By User Intent
| User intent | Read |
|---|---|
| "和 codex/claude 讨论一下", "brainstorm with another agent" | references/workflows.md |
| "派一个 implement/check agent", "让 agent review", "spawn a worker" | references/workflows.md, then references/workers.md |
| "开 issue 区 / topic 群 / changelog / board", "make a forum" | references/forum.md |
| "看看这个 thread / linked context", "inspect a thread" | references/forum.md |
| "channel 卡住了 / 没输出 / progress 被截断", "worker stalled" | references/progress-debugging.md |
| "具体命令怎么写", "what flags does X take" | references/command-reference.md |
Core Rules
- New forum channels use
--type forum. Athreadis one item inside a forum channel. - Use
--context-file/--context-rawandtrellis channel context add/delete/list.--linked-context-*is deprecated terminology. - Use
--stdinor--text-filefor long messages. Do not put long mixed Chinese/English text in the positional shell argument. - Pretty
messagesoutput is an operator dashboard and may truncate progress. Use--rawfor audit. --asis the speaker or worker handle, depending on the command. Use explicit, stable names when multiple agents or sessions are involved.--scope project(default) operates on the current cwd's project bucket;--scope globaloperates on the shared__global__bucket. Pick scope deliberately — a global board is invisible from project listings unless--scope globalis passed.- For brainstorm, do multiple pressure-test rounds. One answer plus one confirmation is review, not brainstorm.
- Dispatcher wait pattern: use
--kind done/--kind turn_finished(trellis-emitted system events), NOT a user--tagas the completion signal. CLI help listsphase_done/questionas--tagexamples but onlyinterruptis a reserved tag with hardcoded trellis behavior; the others are opaque user labels. Relying on a worker to runsend --tag <my_signal>is unreliable — LLM workers commonly write the tag string into prose instead of running the actual CLI command. Seereferences/command-reference.md"tag vs kind". - Forum channels are event-sourced. Do not parse
events.jsonlfirst; useforum,thread,messages --thread, andcontext list. @mindfoldhq/trellis-coreowns reusable channel/thread state, event append, seq allocation, context/title projection, reducers, and task helpers. The CLI owns flags, terminal rendering, prompts, worker lifecycle, and process exits.
Reference Files
references/workflows.md— canonical collaboration patterns A–F (peer brainstorm, spawned review, dispatch-and-wait, forum issue capture, interrupt-and-redirect, one-shot run).references/forum.md— forum channels, context, title, rename, changelog forums, thread filtering.references/workers.md— spawn, agent cards, context injection (--file/--jsonl), interrupts, kill semantics.references/progress-debugging.md— progress/raw inspection, stalled worker diagnosis, OOM guard, exit codes.references/command-reference.md— current CLI command reference (every subcommand, every flag, output conventions, scope/type model).
Not For
- One static review where a markdown file and prompt are enough.
- Replacing normal tool calls with self-logging.
- Long-term memory retrieval. Use durable forum channels for actionable issues, and
trellis mem(thetrellis-session-insightskill) for session/history search.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
