SkillAgentSearch skills...

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-channel

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

85/100

Supported Platforms

Claude Code
OpenAI Codex

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.

Substance
26/30
Structure
16/20
Description
15/15
Adoption
13/20
Freshness
15/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
trellis-channel (this skill)by fy-agent851.2k55d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP 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.

name: 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. A thread is one item inside a forum channel.
  • Use --context-file / --context-raw and trellis channel context add/delete/list. --linked-context-* is deprecated terminology.
  • Use --stdin or --text-file for long messages. Do not put long mixed Chinese/English text in the positional shell argument.
  • Pretty messages output is an operator dashboard and may truncate progress. Use --raw for audit.
  • --as is 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 global operates on the shared __global__ bucket. Pick scope deliberately — a global board is invisible from project listings unless --scope global is 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 --tag as the completion signal. CLI help lists phase_done / question as --tag examples but only interrupt is a reserved tag with hardcoded trellis behavior; the others are opaque user labels. Relying on a worker to run send --tag <my_signal> is unreliable — LLM workers commonly write the tag string into prose instead of running the actual CLI command. See references/command-reference.md "tag vs kind".
  • Forum channels are event-sourced. Do not parse events.jsonl first; use forum, thread, messages --thread, and context list.
  • @mindfoldhq/trellis-core owns 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 (the trellis-session-insight skill) for session/history search.

Related Skills

View on GitHub
GitHub Stars1.2k
CategoryDevelopment
Updated1mo ago
Forks135

Languages

Rust

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium
trellis-channel — Claude Code Skill: Install & Safety Check | SkillAgent