Agent skill

Piece Output Schema

by activepieces in activepieces/activepieces

Generate outputSchema for an Activepieces piece's actions and triggers, so a step's output renders as a curated, labelled tree in the flow builder and data selector.

Custom licenceAuto-check passedProductivity & Automation

Install Piece Output Schema

skills CLI
$ npx skills add activepieces/activepieces --skill piece-output-schema -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install activepieces/activepieces piece-output-schema --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/activepieces/activepieces.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/piece-output-schema .claude/skills/piece-output-schema && rm -rf skills-src

Use ~/.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/

Facts

Skill name
piece-output-schema
GitHub stars
25k
Token cost
~2.2k tokens
SKILL.md length
1,139 words
Files
3
Skills in repo
14
Repo updated
First seen
Licence
Custom licence

At a glance

Generate outputSchema for an Activepieces piece's actions and triggers, so a step's output renders as a curated, labelled tree in the flow builder and data selector.

  • Works in 6 steps: Scope the piece → Learn each step's return shape → Capture the REAL output → …
  • The user asks to add
  • SKILL.md covers The mental model (read this…, Prerequisites, Workflow and Verification checklist, plus 2 more sections
  • Calls npm and npx

What it does

Piece Output Schema is an agent skill from activepieces/activepieces. Generate outputSchema for an Activepieces piece's actions and triggers, so a step's output renders as a curated, labelled tree in the flow builder and data selector. Use when the user asks to add or improve outputSchema for a piece.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `capture-recipes.md` and `schema-reference.md`).

It sits in Productivity & Automation, covering MCP servers and Workflow automation. It works with Model Context Protocol. The repository describes itself as: AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents.

When your agent uses it

  • The user asks to add
  • Improve outputSchema for a piece

Example prompts

  • “s actions and triggers, so a step”
  • “/piece-output-schema”

Requirements

  • Node.js

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Scope the piece
  2. Learn each step's return shape
  3. Capture the REAL output
  4. Curate and author the schema
  5. Validate every path
  6. Wire, version, build, lint

What it can do on your machine

Read from SKILL.md and the folder at commit 40e4639. 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

    Shell commands in SKILL.md call:

    • npm
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm and npx, which can reach the network depending on how they are called.

    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.

Context cost

Piece Output Schema loads about 2.2k tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 1,139 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,139 words (~2,205 tokens).

“An outputSchema turns a step's raw JSON output into a friendly, typed, labelled tree in the flow builder's data selector and output viewer — and a path map that LLM/MCP consumers use to find the fields that matter. This skill…”

— opening of SKILL.md by activepieces, Custom licence
name
piece-output-schema

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files in .agents/skills/piece-output-schema of activepieces/activepieces.

  • SKILL.md
  • capture-recipes.md
  • schema-reference.md

Open the folder on GitHubat commit 40e4639

Compare with similar skills

Piece Output Schema 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.

Piece Output Schema compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Piece Output Schema this skillactivepieces/activepieces25k—~2.2kAutomated safety check: PassCustom licence
Zapier Statuszapier/zapier-mcp430—~1.8kAutomated safety check: PassMIT
n8n Multi-Instance Targetingczlonkowski/n8n-skills6.4k—~3.2kAutomated safety check: PassMIT
Agents Onboardingfazer-ai/agents118—~4.4kAutomated safety check: PassApache-2.0
N8n MCP Tools Expertdavila7/claude-code-templates33k8 repos~3.2kAutomated safety check: PassMIT
n8n MCP Tools Expertczlonkowski/n8n-skills6.4k—~7.6kAutomated safety check: PassMIT

Similar skills

  • Zapier Status

    zapier/zapier-mcp

    Official

    Check the health of your Zapier MCP setup. An agent skill from zapier/zapier-mcp.

    430 GitHub stars~1.8k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • n8n Multi-Instance Targeting

    czlonkowski/n8n-skills

    Keeps an n8n MCP session pointed at the right n8n instance, with rules for discovering, switching and verifying the target before credential writes and for recovering from misroutes.

    6.4k GitHub stars~3.2k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Agents Onboarding

    fazer-ai/agents

    Conduz a jornada de onboarding 'do zero ao agente de atendimento' do fazer.ai agents num VPS, escolhendo o orquestrador de deploy (Tier A Coolify, B Portainer, C compose genérico para VM crua ou…

    118 GitHub stars~4.4k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • N8n MCP Tools Expert

    davila7/claude-code-templates

    Expert guide for using n8n-mcp MCP tools effectively. An agent skill from davila7/claude-code-templates.

    33k GitHub starsUsed in 8 repos~3.2k tokens
    Productivity & AutomationAuto-check passed
  • n8n MCP Tools Expert

    czlonkowski/n8n-skills

    Guides the agent in choosing and calling n8n-mcp tools: finding nodes, validating configurations, deploying templates, managing workflows, folders and credentials, and auditing an instance.

    6.4k GitHub stars~7.6k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • MCP Urgent Caller Triage

    zapier/gtm-cheat-codes

    Official

    Prioritize inbound client calls by reading transcripts, classifying urgency, matching callers to legal client and matter context, and preparing a callback list for human review.

    342 GitHub stars~1k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed

More from activepieces/activepieces

All 14 skills in this repo
  • Analyze Logs

    activepieces/activepieces

    Analyze application logs from the .evlog/logs/ directory. An agent skill from activepieces/activepieces.

    25k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Activepieces Design System

    activepieces/activepieces

    Design system for Activepieces (open-source AI automation platform, "open source replacement for Zapier").

    25k GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Piece Builder

    activepieces/activepieces

    Build and edit Activepieces pieces (integrations) — creating new pieces, adding actions or triggers, or fixing bugs in existing ones.

    25k GitHub stars~3.1k tokensUpdated today
    Auto-check: notes
  • Profile App Cpu

    activepieces/activepieces

    Find what is burning CPU in a live app container without restarting it: separate the JS thread from GC and libuv, open the V8 inspector in place with SIGUSR1, take a CPU profile over CDP, and…

    25k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Profile Worker Memory

    activepieces/activepieces

    Diagnose a worker that is growing memory or being OOM-killed: separate a JS-heap leak from native growth, take a V8 heap snapshot of a live worker in place (never uploading it), and walk the…

    25k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Triage Dependabot Alerts

    activepieces/activepieces

    Triage Dependabot dependency vulnerability alerts for the Activepieces repo — pull open alerts, dedupe to distinct (package, advisory), confirm the vulnerable package + API is actually used, and…

    25k GitHub stars~2.9k tokensUpdated today
    Auto-check passed

Questions about Piece Output Schema

What does Piece Output Schema do?

Generate outputSchema for an Activepieces piece's actions and triggers, so a step's output renders as a curated, labelled tree in the flow builder and data selector. Piece Output Schema is an agent skill from activepieces/activepieces. Generate outputSchema for an Activepieces piece's actions and triggers, so a step's output renders as a curated, labelled tree in the flow builder and data selector.

When should I use Piece Output Schema?

Piece Output Schema fits situations like: the user asks to add; improve outputSchema for a piece.

How do I install Piece Output Schema in Claude Code?

Run `npx skills add activepieces/activepieces --skill piece-output-schema -a claude-code`. Or copy the skill folder (.agents/skills/piece-output-schema in activepieces/activepieces) into .claude/skills/piece-output-schema in your project. Claude Code loads it when a task matches its description.

How do I install Piece Output Schema in Codex?

Run `npx skills add activepieces/activepieces --skill piece-output-schema -a codex`. Or copy the skill folder (.agents/skills/piece-output-schema in activepieces/activepieces) into .agents/skills/piece-output-schema in your project. Codex loads it when a task matches its description.

Can I use Piece Output Schema 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 activepieces/activepieces --skill piece-output-schema -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/piece-output-schema, .gemini/skills/piece-output-schema, .github/skills/piece-output-schema and .opencode/skills/piece-output-schema in your project.

What does Piece Output Schema need to run?

Going by SKILL.md and its folder, Piece Output Schema needs the command-line tools its instructions call (npm and npx). Our summary lists: Node.js.

Does Piece Output Schema access the network?

SKILL.md contains no URLs. Its commands use npm and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Piece Output Schema 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 Piece Output Schema use?

Piece Output Schema has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Piece Output Schema use?

About 2.2k tokens (SKILL.md is roughly 8.8k 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 Piece Output Schema?

Skills that share tags, products or a category with Piece Output Schema: Zapier Status (zapier/zapier-mcp, 430 stars), n8n Multi-Instance Targeting (czlonkowski/n8n-skills, 6.4k stars), Agents Onboarding (fazer-ai/agents, 118 stars) and N8n MCP Tools Expert (davila7/claude-code-templates, 33k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Piece Output Schema?

activepieces (a GitHub organization) maintains it in activepieces/activepieces, which has 24,970 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 10, 2026.

Source: activepieces/activepieces on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.