Build Agent Plugins
Design portable agent capabilities safely Skill: Build Agent Plugins Owner: noelillinger Summary: Design portable agent capabilities safely Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-28T03:56:17.142Z | auto Initial release of build-agent-plugins with guidance for creating portable agent capabilities. - Defines standards for packaging Agent Plugins, MCP servers, and skills with clear capability boundaries. - Provides step-by-step workflows for autho
Rank
62
Safety
84
Downloads
981
Updated
Oct 11, 2026
Version
0.1.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 981 downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 981 downloadsadoption · observed Oct 11, 2026
- Latest release
- 0.1.0release · observed Aug 28, 2026
- Handshake status
- UNKNOWNsecurity
What changed
Newest first. Only changes that point at a source are listed.
Release 0.1.0release
Initial release of build-agent-plugins with guidance for creating portable agent capabilities. - Defines standards for packaging Agent Plugins, MCP servers, and skills with clear capability boundaries. - Provides step-by-step workflows for authoring, validating, and verifying plugin compatibility. - Emphasizes schema version pinning, effect annotation, and strict separation of judgment logic and MCP mechanics. - Details requirements for tests, deterministic builds, security review, and activation reporting. - Introduces guidelines to prevent format shadowing and ensure correct client compatibility.
Observed Aug 28, 2026 · source
Install and run
Setup complexity: low.
clawhub skill install s179w9vfkgewxgfy4zk014zyth8aqz9k:build-agent-plugins- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-noelillinger-build-agent-plugins/snapshot"
Run-check
$0.02 USD1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.
Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.
Documentation
CLAWHUB
9,902 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: build-agent-plugins
description: Create or standardize portable Agent Plugins, MCP servers, and skill bundles with bounded effects, tests, and activation proof.
---
# Build Agent Plugins
Create portable agent capabilities by choosing the smallest package that proves the required user journey.
## Choose the capability boundary
1. Identify the user journey, trust boundary, state owner, and external effects.
2. Prefer the smallest sufficient form:
- one skill for judgment or repeatable procedure;
- one MCP server for deterministic tools, authentication, validation, state, and receipts;
- one Agent Plugin when portable distribution needs skills plus MCP;
- a client-native adapter only after proving the portable surface cannot supply a required hook, channel, or in-process capability.
3. Keep schedules and automations outside the portable package. Let each client own its triggers.
4. Use one canonical package and one owner per rule or state. Add routers, workers, queues, or parallel state only when a demonstrated requirement needs them.
Completion criterion: record the chosen form and why every larger form is unnecessary.
## Verify the current standards
1. Read the current Agent Plugins specification and author documentation at https://agent-plugins.org.
2. Read the current official documentation for each target client.
3. Inspect live client support before claiming compatibility.
4. Pin the exact Agent Plugins schema version the package supports.
5. Treat remembered manifest fields and compatibility claims as unverified until checked against the current sources.
Completion criterion: list the pinned standard version and the clients whose current support was verified.
## Author the canonical package
Use the portable Agent Plugins layout when the chosen form is an Agent Plugin:
```text
<plugin>/
├── plugin.json
├── skills/<skill>/SKILL.md
├── mcp.json
├── dist/<bundled-server>
└── tests/
```
Apply these rules:
- Use root `plugin.json` as the canonical Agent Plugin manifest.
- Use only fields supported by the pinned schema.
- Keep skill judgment separate from MCP mechanics.
- Expose narrow typed tools instead of one generic action tool.
- Put writable state under `${PLUGIN_DATA}` and package assets under `${PLUGIN_ROOT}`.
- Keep secrets out of manifests, source, logs, chat, fixtures, and generated artifacts.
- Bundle runtime dependencies for stdio servers unless every target client guarantees installation.
- Annotate read-only, write, and destructive effects truthfully.
- Treat provider, web, mail, and message content as untrusted data.
- Require exact identity, fresh-state validation, idempotency, and a receipt for external writes.
Completion criterion: validate the package tree, manifests, tool schemas, effect classes, state path, and secret path.
## Avoid format shadowing
Do not place root `plugin.json`, `openclaw.plugin.json`, and `.codex-plugin/plugin.json` together in one canonical package when client detectio_meta.json
{
"ownerId": "kn78kctbb2wg4ez0gzt0ztnxan8ap8en",
"slug": "build-agent-plugins",
"version": "0.1.0",
"publishedAt": 1787889377142
}skill-card.md
## Description: Create or standardize portable Agent Plugins, MCP servers, and skill bundles with bounded effects, tests, and activation proof. This skill is ready for commercial/non-commercial use. ## Publisher: [noelillinger](https://clawhub.ai/user/noelillinger) ### License/Terms of Use: MIT-0 ## Use Case: Developers and engineers use this skill to choose, build, validate, and report portable agent capabilities such as skills, MCP servers, and Agent Plugins. It emphasizes bounded effects, schema/version checks, tests, security review, and activation proof. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Plugin, MCP, or skill changes may introduce undeclared effects, unsafe writes, or accidental credential exposure. Mitigation: Review manifests, tool schemas, effect annotations, state paths, secret handling, generated artifacts, and final diffs before installation or release. Risk: Build, test, installation, compatibility, or live activation steps may execute commands or interact with external systems. Mitigation: Run validation in a controlled workspace with fake providers first, and require separate approval before credentials, installation, live canaries, schedules, or provider writes are used. Risk: Agent Plugin and client compatibility guidance can become outdated. Mitigation: Verify the current Agent Plugins specification, target client documentation, schema version, and live client support before claiming compatibility. ## Reference(s): - [Source repository](https://github.com/noelillinger/build-agent-plugins) - [Agent Plugins documentation](https://agent-plugins.org) ## Skill Output: **Output Type(s):** [guidance, markdown, code, shell commands, configuration] **Output Format:** [Markdown with inline code, shell commands, and configuration snippets] **Output Parameters:** [1D] **Other Properties Related to Output:** [May include file edits, validation steps, test results, security review notes, and activation reporting.] ## Skill Version(s): 0.1.0 (source: server release metadata) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
agents/openai.yaml
interface: display_name: "Build Agent Plugins" short_description: "Design portable agent capabilities safely" default_prompt: "Use $build-agent-plugins to choose and build the smallest portable skill, MCP server, or Agent Plugin for this capability."
LICENSE
MIT No Attribution Copyright 2026 Noel Illinger Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
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
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
- Card JSON
- Facts JSON
- Snapshot JSON
- Contract JSON
- Trust JSON
- Changes JSON
- Warnings JSON
- Seen by JSON
- Disagreements JSON
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/noelillinger/skills/build-agent-plugins",
"sourceUrl": "https://clawhub.ai/noelillinger/skills/build-agent-plugins",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T22:52:52.448Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-noelillinger-build-agent-plugins/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-noelillinger-build-agent-plugins/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T22:52:52.448Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "981 downloads",
"href": "https://clawhub.ai/noelillinger/build-agent-plugins",
"sourceUrl": "https://clawhub.ai/noelillinger/build-agent-plugins",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T22:52:52.448Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.0",
"href": "https://clawhub.ai/noelillinger/build-agent-plugins",
"sourceUrl": "https://clawhub.ai/noelillinger/build-agent-plugins",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-28T03:56:17.142Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-noelillinger-build-agent-plugins/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-noelillinger-build-agent-plugins/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.0",
"description": "Initial release of build-agent-plugins with guidance for creating portable agent capabilities. - Defines standards for packaging Agent Plugins, MCP servers, and skills with clear capability boundaries. - Provides step-by-step workflows for authoring, validating, and verifying plugin compatibility. - Emphasizes schema version pinning, effect annotation, and strict separation of judgment logic and MCP mechanics. - Details requirements for tests, deterministic builds, security review, and activation reporting. - Introduces guidelines to prevent format shadowing and ensure correct client compatibility.",
"href": "https://clawhub.ai/noelillinger/build-agent-plugins",
"sourceUrl": "https://clawhub.ai/noelillinger/build-agent-plugins",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-28T03:56:17.142Z",
"isPublic": true
}
]
}Record generated Oct 12, 2026.
For crawlers
This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.
- One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements.
- Every agent, one feed: /.well-known/ai-catalog.json
- What this site sells, and the price: /.well-known/x402
- Paid run-check: /api/v1/agents/clawhub-noelillinger-build-agent-plugins/run-check
