agent-plugins-spec
Agent Plugins Specification v1.0.0 — A minimal standard for packaging agent extensions into distributable plugins
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/agentplugins/agent-plugins-spec with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/agentplugins/agent-plugins-spec'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/agentplugins--agent-plugins-spec)HTML
<a href="/listings/agentplugins--agent-plugins-spec"><img src="/api/listings/agentplugins--agent-plugins-spec/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
The smallest useful plugin is a directory with one skill:
hello-plugin/
├── plugin.json
└── skills/
└── greet/
└── SKILL.mdIn `plugin.json`:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "hello-plugin"
}In `skills/greet/SKILL.md`:
--- name: greet description: Greet the user and offer help. --- Greet the user and offer help.
A client that supports skills can load the plugin by reading `plugin.json` and discovering `skills/greet/SKILL.md`. How the client exposes the skill to users or models is outside the Agent Plugins specification.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 52 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Agent Plugins
- Agent Plugins is an open, vendor-neutral standard for packaging reusable components that extend AI agents into distributable plugins. The published 1.0 specification defines a portable package format for Agent Skills and MCP servers; the 1.1.0 working draft adds portable hooks.
- This README is a non-normative introduction. The versioned specification defines the portable contract.
- ## Status
- Agent Plugins Specification 1.0.0 is the current published release. Agent Plugins Specification 1.1.0 is a working draft.
- ## Quick Start
- The smallest useful plugin is a directory with one skill:
- ```text
- hello-plugin/
- ├── plugin.json
- └── skills/
- └── greet/
- └── SKILL.md
- ```
- In `plugin.json`:
- ```json
- {
- "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
- "name": "hello-plugin"
- }
- ```
- In `skills/greet/SKILL.md`:
- ```markdown
- ---
- name: greet
- description: Greet the user and offer help.
- ---
- Greet the user and offer help.
- ```
- A client that supports skills can load the plugin by reading `plugin.json` and discovering `skills/greet/SKILL.md`. How the client exposes the skill to users or models is outside the Agent Plugins specification.
- ## Project Documents
- - [Agent Plugins Specification 1.0.0](./spec/1.0.0.md)
- - [1.0.0 schemas](./schemas/1.0.0/)
- - [Agent Plugins Specification 1.1.0 (working draft)](./spec/1.1.0.md)
- - [1.1.0 schemas](./schemas/1.1.0/)
- - [Technical Charter](./GOVERNANCE.md)
- - [Future considerations](./FUTURE_CONSIDERATIONS.md)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.