Community catalog of experts and plugins for Octop.
Octop installs experts, skills, and plugins from this catalog. The Octop wheel does not ship these packages, and Octop does not read this tree at startup.
experts/ one directory per expert; skills live in skills/<name>/
plugins/ one directory per plugin (plugin.yaml + main.py)
There is no separate skill directory. A skill is the skills/<name>/SKILL.md package inside its expert.
experts/<id>/
├── manifest.json # id matches the directory name; label and description in zh and en
├── SOUL.md
├── avatar.png # or avatar.jpg
└── skills/<name>/
└── SKILL.md
Put the portrait in that expert directory and name it avatar.png or avatar.jpg. If manifest.json has icon_url, set it to that same filename. The publisher copies this file next to the expert zip.
- Draw it at 128×128.
- Use PNG for a flat illustration and JPG for a photo-like portrait.
- JPG and PNG only. Do not commit SVG, AVIF, WebP, or a remote image URL.
- Do not put the portrait in
assets/avatars/or.octop/.
plugins/<id>/
├── plugin.yaml # id matches the directory name
├── main.py
└── icon.svg # optional
plugin.yaml needs id, version, name, description, entry, and kind.
Pull requests are welcome. Experts, plugins, skills, translations, and fixes all belong here.
- Fork this repository and branch from
main. - Add or update one expert or one plugin. Keep the directory name equal to its
id. - Write user-facing copy in both Chinese and English when the format has
zhandenfields. - Leave secrets, tokens, and private data out. Keep a license file inside a package when you are not the one who can relicense it.
- Open a pull request against
mainand say what the package does and how you checked it.
Review looks at whether the package matches the layout above, whether the description matches what it actually does, and whether the diff stays limited to that package.
A merge into master or main builds octop/market/, uploads it to COS, then refreshes the CDN directories with PurgePathCache. Zip files, icons, and meta.json go up before the two index.json files. Secrets are listed in .github/workflows/publish-market.yml.