peter-gy/agent-plugins / skills/package-agent-plugin
package-agent-plugin
VerifiedPackage 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.6 KB |
| agents/openai.yaml | config | 235 B |
| references/briefings.md | markdown | 6.8 KB |
| references/build-variants.md | markdown | 1.8 KB |
| references/verify-artifacts.md | markdown | 1.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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 470k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |