Skip to content

peter-gy/agent-plugins / skills/package-agent-plugin

package-agent-plugin

Verified

Package version-matched agent briefings with a Python project. Use when authoring core skills and references, exposing guidance through Python module help, configuring a build adapter, attaching a plugin to a wheel, or verifying installed handoffs. For consuming an installed package's instructions, use agent-plugins.

FileKindSize
SKILL.mdskill md5.6 KB
agents/openai.yamlconfig235 B
references/briefings.mdmarkdown6.8 KB
references/build-variants.mdmarkdown1.8 KB
references/verify-artifacts.mdmarkdown1.9 KB

references/build-variants.md

View on GitHub
# Build variants

## Hatchling

Wrap an existing Hatchling project with the bundled adapter:

```toml
[build-system]
requires = ["agent-plugins", "hatchling"]
build-backend = "agent_plugins.build.hatchling"

[tool.agent-plugins]
root = "."
```

The adapter preserves the delegate's wheel, source distribution, and editable
behavior while adding the selected Agent Plugin and installation marker.

## Monorepo roots

Resolve `root` relative to the `pyproject.toml` that owns the build. For this
layout, the Python package points back to the repository plugin root:

```text
repository/
|-- plugin.json
|-- skills/
`-- packages/
    `-- python/
        `-- pyproject.toml
```

```toml
[tool.agent-plugins]
root = "../.."
```

## Additional selected files

The build always selects `plugin.json`, the complete `skills/` tree, and
`mcp.json` when present. Select other root-relative files explicitly:

```toml
[tool.agent-plugins]
root = "."
include = ["bin/**", "com.example.client/**"]
```

Every include pattern must remain inside the plugin root and match at least one
filesystem entry. A matched directory contributes its regular files.

## Prebuilt wheels

When another backend owns the wheel, attach the configured Agent Plugin after
that build:

```console
agent-plugins attach-wheel dist/my_package-0.1.0-py3-none-any.whl \
  --project .
```

The command atomically replaces the input wheel after the complete attached
artifact succeeds. Use `--output-dir` to preserve the source wheel. The Python
API exposes the same operation:

```python
import agent_plugins as ap

result = ap.attach_wheel(
    "dist/my_package-0.1.0-py3-none-any.whl",
    project=".",
)
print(result.output)
```

A custom delegate must expose wheel, source distribution, and editable build
hooks together with their corresponding `get_requires_for_build_*` hooks.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall