Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/agentplugins--agent-plugins-spec/badge.svg)](/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

i

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.md

In `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.

  1. # Agent Plugins
  2. 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.
  3. This README is a non-normative introduction. The versioned specification defines the portable contract.
  4. ## Status
  5. Agent Plugins Specification 1.0.0 is the current published release. Agent Plugins Specification 1.1.0 is a working draft.
  6. ## Quick Start
  7. The smallest useful plugin is a directory with one skill:
  8. ```text
  9. hello-plugin/
  10. ├── plugin.json
  11. └── skills/
  12. └── greet/
  13. └── SKILL.md
  14. ```
  15. In `plugin.json`:
  16. ```json
  17. {
  18. "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  19. "name": "hello-plugin"
  20. }
  21. ```
  22. In `skills/greet/SKILL.md`:
  23. ```markdown
  24. ---
  25. name: greet
  26. description: Greet the user and offer help.
  27. ---
  28. Greet the user and offer help.
  29. ```
  30. 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.
  31. ## Project Documents
  32. - [Agent Plugins Specification 1.0.0](./spec/1.0.0.md)
  33. - [1.0.0 schemas](./schemas/1.0.0/)
  34. - [Agent Plugins Specification 1.1.0 (working draft)](./spec/1.1.0.md)
  35. - [1.1.0 schemas](./schemas/1.1.0/)
  36. - [Technical Charter](./GOVERNANCE.md)
  37. - [Future considerations](./FUTURE_CONSIDERATIONS.md)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.