Repository navigation
[FEATURE]: Portable Agent Packages with Bundled Skills #10430
Description
Feature hasn't been suggested before.
- I have verified this feature I'm about to request hasn't been suggested before.
Describe the enhancement you want to request
I've been developing some agents, and something I found would be really cool is if we could make agents more portable. For example, I want to share an agent with my team, but I have skills that are dedicated just for that agent. Right now, there's no easy way to bundle everything together from what I found.
Proposed Solution
Support a standardized agent package structure that bundles agents with their dedicated skills:
~/.config/opencode/agent/my_agent/
├── AGENT.md
├── skills/
│ ├── skill-1/SKILL.md
│ ├── skill-2/SKILL.md
│ └── skill-3/SKILL.md
└── config.json (optional)
- Package as a single folder (zip/archive for easy sharing)
- Simple import command:
opencode import agent-package.zip - Optional
config.jsonto keepAGENT.mdleaner
Use Cases
- Share custom agents across team members
- Distribute specialized agents for specific workflows
- Version control agent packages independently
It could even expand to other configuration needs related to agents, here I just showcased a potential use case for skills and config portability, but I think there could be more plug-in that I have not thought about that could be placed inside the agent folder as well
I know this is not strictly new, I just didn't want to disrupt possible related ideas on these similarly related issues:
#5052
#3471
#6635
Activity
github-actions commentedon Jan 24, 2026
This issue might be a duplicate of existing issues. Please check:
Feel free to ignore if none of these address your specific case.
diegohb commentedon Feb 12, 2026
@jorgedanisc in the meantime, I've had a lot of luck using opencode-architect with some instruction about a "non-code plugin" but essentially it's a plugin. see example structure here. Today I made 2 other packages by using the opencode-architect agent and saying extract these skills and package them like github repo X (intellisearch).
Also, today I discovered playbooks.com which installs to ~/.agents/ dir, a new pattern that seems to be evolving for packaging these.
github-actions commentedon Apr 14, 2026
To stay organized issues are automatically closed after 90 days of no activity. If the issue is still relevant please open a new one.