Claude Code Agent Development
anthropics/claude-plugins-official
Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.
Delegate work to sub-agents as visible Pier terminal panels.
Install Pier Subagent Panels
$ npx skills add runloom/pier --skill pier-subagent-panels -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install runloom/pier pier-subagent-panels --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/runloom/pier.git skills-src && mkdir -p .claude/skills && cp -r skills-src/resources/system-skills/pier-subagent-panels .claude/skills/pier-subagent-panels && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "pier-subagent-panels" agent skill from https://github.com/runloom/pier/tree/main/resources/system-skills/pier-subagent-panels into .claude/skills/pier-subagent-panels/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pier-subagent-panels", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/runloom/pier/tree/main/resources/system-skills/pier-subagent-panelsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add runloom/pier --skill pier-subagent-panels -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install runloom/pier pier-subagent-panels --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/runloom/pier.git skills-src && mkdir -p .agents/skills && cp -r skills-src/resources/system-skills/pier-subagent-panels .agents/skills/pier-subagent-panels && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "pier-subagent-panels" agent skill from https://github.com/runloom/pier/tree/main/resources/system-skills/pier-subagent-panels into .agents/skills/pier-subagent-panels/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pier-subagent-panels", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add runloom/pier --skill pier-subagent-panels -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install runloom/pier pier-subagent-panels --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/runloom/pier.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/resources/system-skills/pier-subagent-panels .cursor/skills/pier-subagent-panels && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "pier-subagent-panels" agent skill from https://github.com/runloom/pier/tree/main/resources/system-skills/pier-subagent-panels into .cursor/skills/pier-subagent-panels/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pier-subagent-panels", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/runloom/pier.git --path resources/system-skills/pier-subagent-panels--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add runloom/pier --skill pier-subagent-panels -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install runloom/pier pier-subagent-panels --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/runloom/pier.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/resources/system-skills/pier-subagent-panels .gemini/skills/pier-subagent-panels && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "pier-subagent-panels" agent skill from https://github.com/runloom/pier/tree/main/resources/system-skills/pier-subagent-panels into .gemini/skills/pier-subagent-panels/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pier-subagent-panels", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install runloom/pier pier-subagent-panelsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add runloom/pier --skill pier-subagent-panels -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/runloom/pier.git skills-src && mkdir -p .github/skills && cp -r skills-src/resources/system-skills/pier-subagent-panels .github/skills/pier-subagent-panels && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "pier-subagent-panels" agent skill from https://github.com/runloom/pier/tree/main/resources/system-skills/pier-subagent-panels into .github/skills/pier-subagent-panels/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pier-subagent-panels", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add runloom/pier --skill pier-subagent-panels -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install runloom/pier pier-subagent-panels --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/runloom/pier.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/resources/system-skills/pier-subagent-panels .opencode/skills/pier-subagent-panels && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "pier-subagent-panels" agent skill from https://github.com/runloom/pier/tree/main/resources/system-skills/pier-subagent-panels into .opencode/skills/pier-subagent-panels/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pier-subagent-panels", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
pier-subagent-panels- GitHub stars
- 105
- Token cost
- ~626 tokens
- SKILL.md length
- 202 words
- Files
- 1
- Skills in repo
- 4
- Repo updated
- First seen
- Licence
- AGPL-3.0
At a glance
Delegate work to sub-agents as visible Pier terminal panels.
- Tasks that involve Subagents
- SKILL.md covers Agent-specific guidance, Delegation CLI, Verbs and When to delegate vs built-in…, plus 2 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Pier Subagent Panels is an agent skill from runloom/pier. Delegate work to sub-agents as visible Pier terminal panels. Check your agent type first: if you are Claude Code with teams mode active, use your native teammate spawning instead (the adapter already maps teammates to Pier panels). For all other agents (omp, codex, opencode without omo, gemini, etc.), use pier agents start to delegate work into observable Pier panels.
Its SKILL.md is about 630 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires running inside a Pier agent panel (PIERPANELID / PIERWINDOWID must be set by the host).
It sits in Agent Workflows, covering Subagents. The repository describes itself as: 几个 AI 终端开着，谁在等你一眼能看见。Claude Code、Codex 还在原来的终端里，旁边就能改文件、看 Git。macOS 本地工作台。 The licence is AGPL-3.0.
When your agent uses it
- Tasks that involve Subagents
Example prompts
- “/pier-subagent-panels”
Requirements
- Compatibility (from SKILL.md): Requires running inside a Pier agent panel (PIER_PANEL_ID / PIER_WINDOW_ID must be set by the host).
What it can do on your machine
Read from SKILL.md and the folder at commit 32403c0. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Requires running inside a Pier agent panel (PIER_PANEL_ID / PIER_WINDOW_ID must be set by the host).
From compatibility in the SKILL.md frontmatter.
Context cost
Pier Subagent Panels loads about 626 tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 202 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from runloom/pier at commit 32403c0, republished under its AGPL-3.0 licence (© runloom). 202 words, ~626 tokens.
Download SKILL.mdSave it as
.claude/skills/pier-subagent-panels/SKILL.md (or your agent's skills folder).- name
- pier-subagent-panels
- description
- Delegate work to sub-agents as visible Pier terminal panels. Check your agent type first: if you are Claude Code with teams mode active, use your native teammate spawning instead (the adapter already maps teammates to Pier panels). For all other agents (omp, codex, opencode without omo, gemini, etc.), use `pier agents start` to delegate work into observable Pier panels.
- compatibility
- Requires running inside a Pier agent panel (PIER_PANEL_ID / PIER_WINDOW_ID must be set by the host).
- disable-model-invocation
- true
Delegate Work to Subagent Panels
Spawn sub-agents in Pier background tabs so the user can watch, interject, or take over the session.
Agent-specific guidance
Claude Code (teams preset active): Do NOT use this skill. Your native teammate spawning already goes through the Pier adapter — teammates automatically appear as Pier panels.
All other agents (omp, codex, opencode, gemini, etc.): Use the delegation CLI below. This is the only way to get your sub-agents into visible Pier panels.
Delegation CLI
# ALWAYS pass --cwd "$(pwd)" — ensures the sub-agent works in the same
# project directory as you (avoids Claude Code's workspace trust prompt
# in $HOME, and keeps the sub-agent on the correct project).
pier agents start <agentId> --stdin --cwd "$(pwd)" [--placement tab|right|below]- Default
tab: background tab, no focus steal. right/below: split anchored to your panel.
Verbs
pier agents start <agentId> --stdin— spawn + deliver first promptpier agents turn --runtime <id> --boot <id> --generation <n> --stdin— follow-uppier agents screen ...— capture viewport (bounded, no scrollback)pier agents wait ... --until ready|waiting|exited|attention— state predicate, NOT a completion verdict
When to delegate vs built-in subagents
- Short, synchronous, result-only → built-in task/subagents
- Long-running, parallel, needs user visibility → delegate to panel
Retry
Failed agents.start may carry details: { operationId, observedBootId, scope: "same-boot", crashAmbiguous, safeToRetry }.
- Timeout/unknown outcome: re-issue with SAME
--operation-id(idempotent, never double-spawns) - Definitive failure replayed: fix cause, start NEW attempt with FRESH id
- Same-boot only; after restart, fresh start needs no credentials
Escape hatch
PIER_AGENT_PANELS_DISABLED=1 → pier agents start fails at parse time.
© runloom, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in resources/system-skills/pier-subagent-panels of runloom/pier.
Open the folder on GitHubat commit 32403c0
Compare with similar skills
Pier Subagent Panels next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Pier Subagent Panels this skillrunloom/pier | 105 | — | ~626 | Automated safety check: Pass | AGPL-3.0 | |
| Claude Code Agent Developmentanthropics/claude-plugins-official | 38k | 7 repos | ~2.8k | Automated safety check: Pass | Apache-2.0 | |
| Subagent Driven DevelopmentAsvarox/allkaraoke | 261 | 37 repos | ~1.2k | Automated safety check: Pass | None | |
| Dispatching Parallel Agentsultralisp/ultralisp | 258 | 40 repos | ~1.5k | Automated safety check: Pass | None | |
| Paseo Advisor Second Opiniongetpaseo/paseo | 20k | 1 repos | ~756 | Automated safety check: Pass | Custom licence | |
| Task Observerrebelytics/one-skill-to-rule-them-all | 3.2k | 1 repos | ~12k | Automated safety check: Pass | CC-BY-4.0 |
Similar skills
- Official
Subagent Driven Development
Asvarox/allkaraoke
A skill your agent uses when executing implementation plans with independent tasks in the current session
Dispatching Parallel Agents
ultralisp/ultralisp
A skill your agent uses when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
Paseo Advisor Second Opinion
getpaseo/paseo
Launches one separate agent through Paseo to give a second opinion on the current task, with a self-contained briefing and no permission to edit files.
Task Observer
rebelytics/one-skill-to-rule-them-all
Monitors task execution for skill improvement opportunities.
O2 Review Loop
openobserve/openobserve
Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.
More from runloom/pier
Publish Project
runloom/pier
发布 Pier：合入 main 后先插件后宿主。宿主默认发候选版（vX.Y.Z-rc.N prerelease）， 「晋升正式版」打稳定 tag；「直接发布」显式跳过候选直达正式版。触发：/publish-project、 发版、晋升正式版、直接发布。默认全自动，不中途询问版本号 / 合并 / 打 tag。
Pier Canvas
runloom/pier
Create or update a Pier Canvas under .pier/canvases using pier/canvas, pier/host, and project components.
Deslop
runloom/pier
(no description)
Related
Categories
Questions about Pier Subagent Panels
What does Pier Subagent Panels do?
Delegate work to sub-agents as visible Pier terminal panels. Pier Subagent Panels is an agent skill from runloom/pier. Delegate work to sub-agents as visible Pier terminal panels.
When should I use Pier Subagent Panels?
Pier Subagent Panels fits situations like: tasks that involve Subagents.
How do I install Pier Subagent Panels in Claude Code?
Run `npx skills add runloom/pier --skill pier-subagent-panels -a claude-code`. Or copy the skill folder (resources/system-skills/pier-subagent-panels in runloom/pier) into .claude/skills/pier-subagent-panels in your project. Claude Code loads it when a task matches its description.
How do I install Pier Subagent Panels in Codex?
Run `npx skills add runloom/pier --skill pier-subagent-panels -a codex`. Or copy the skill folder (resources/system-skills/pier-subagent-panels in runloom/pier) into .agents/skills/pier-subagent-panels in your project. Codex loads it when a task matches its description.
Can I use Pier Subagent Panels in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add runloom/pier --skill pier-subagent-panels -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pier-subagent-panels, .gemini/skills/pier-subagent-panels, .github/skills/pier-subagent-panels and .opencode/skills/pier-subagent-panels in your project.
What does Pier Subagent Panels need to run?
SKILL.md names no scripts, command-line tools or credentials: Pier Subagent Panels is instructions for the agent only. Compatibility (from SKILL.md): Requires running inside a Pier agent panel (PIER_PANEL_ID / PIER_WINDOW_ID must be set by the host)..
Does Pier Subagent Panels access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Pier Subagent Panels safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Pier Subagent Panels use?
Pier Subagent Panels is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Pier Subagent Panels use?
About 626 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Pier Subagent Panels?
Skills that share tags, products or a category with Pier Subagent Panels: Claude Code Agent Development (anthropics/claude-plugins-official, 38k stars), Subagent Driven Development (Asvarox/allkaraoke, 261 stars), Dispatching Parallel Agents (ultralisp/ultralisp, 258 stars) and Paseo Advisor Second Opinion (getpaseo/paseo, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Pier Subagent Panels?
runloom (a GitHub organization) maintains it in runloom/pier, which has 105 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 2, 2026.
Source: runloom/pier on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.