Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
# Agent Plugins contributor guide

This repository owns reusable plugin content under `plugins/`. The AllAgents CLI, client adapters and workspace examples belong in `allagentsdev/allagents`.
This repository owns reusable plugin content under `plugins/` and workspace templates under the sibling `workspaces/` directory. The AllAgents CLI, client adapters and CLI-specific examples belong in `allagentsdev/allagents`.

- Work on a dedicated branch/worktree from current `origin/main`; publish changes through a pull request. Never push implementation directly to `main` or merge without user authorization. Use conventional commit and PR titles; squash merges.
- Keep workspace recipes portable. Use original upstream skill sources, preserve copied recipes' behavior, and document software/account prerequisites separately from skill installation.
- Keep `.claude-plugin/marketplace.json` and `.github/plugin/marketplace.json` aligned for the complete catalogue. Both use the marketplace name `agent-plugins` and local paths to plugin directories.
- Preserve plugin names, licensing, attribution, executable file modes and supporting resources. Update plugin homepages and local links when moving files.
- Keep skills scoped to reusable capabilities. Keep household data, private service configuration, credentials and downloaded personal workbooks in their private repositories.
Expand Down
23 changes: 17 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Agent Plugins

Reusable plugins for AI assistants, maintained by AllAgents. This repository is the plugin catalogue; the [AllAgents CLI and workspace examples](https://github.com/allagentsdev/allagents) remain in their own repository.
Reusable plugins for AI assistants, maintained by AllAgents. This repository owns the plugin catalogue and [workspace templates](workspaces). The [AllAgents CLI and client adapters](https://github.com/allagentsdev/allagents) remain in their own repository.

## Install

Expand Down Expand Up @@ -46,14 +46,25 @@ Save personal selections and private reports in `~/.agents/github-attention.md`,

## Workspace templates

Workspace templates remain under [allagents/examples/workspaces](https://github.com/allagentsdev/allagents/tree/main/examples/workspaces). They compose plugins from this catalogue and other sources:
[Workspace templates](workspaces) live beside `plugins/` and compose this
catalogue with original upstream sources:

```yaml
plugins:
- finance@allagentsdev/agent-plugins
- engineering@allagentsdev/agent-plugins
| Template | Purpose |
| --- | --- |
| [Designer](workspaces/designer) | Interfaces, film, video editing, motion, audio review and marketing |
| [Engineering](workspaces/engineering) | Portable engineering skills and Pi-native tooling |
| [Finance](workspaces/finance) | Financial models, budgets, forecasts and workpapers |

```sh
allagents workspace init ./designer \
--from allagentsdev/agent-plugins/workspaces/designer
```

Read each template's prerequisites first. Skill installation is separate from
media software, service authentication and paid generation. Engineering and
Finance were copied from the AllAgents examples; CLI-specific examples remain
in that repository.

The companion AllAgents migration preserves the old marketplace declarations, such as `finance@allagentsdev/allagents`, through external sources. Direct old directory URLs for the moved plugins do not redirect: replace `allagentsdev/allagents/plugins/<name>` with `<name>@allagentsdev/agent-plugins`. Upgrade AllAgents before using the migrated forwarding marketplace. Pinned historical versions continue to use their original content.

## Development
Expand Down
30 changes: 30 additions & 0 deletions workspaces/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Workspace templates

These recipes compose plugins and original upstream skills into a project
workspace. Reusable plugins and workspace compositions live together in this
repository; the CLI and client adapters live in
[allagentsdev/allagents](https://github.com/allagentsdev/allagents).

| Workspace | Purpose |
| --- | --- |
| [Designer](designer) | Interfaces, film, editing, motion, audio review and marketing |
| [Engineering](engineering) | Portable engineering skills and Pi-native tools |
| [Finance](finance) | Financial modeling, budgets, forecasts and workpapers |

Use the template's README for prerequisites and account setup. For example:

```sh
allagents workspace init ./designer \
--from allagentsdev/agent-plugins/workspaces/designer
```

Engineering and Finance were copied from the AllAgents
[engineering](https://github.com/allagentsdev/allagents/tree/782ffc9/examples/workspaces/engineering)
and [finance](https://github.com/allagentsdev/allagents/tree/782ffc9/examples/workspaces/finance)
examples. Their workspace declarations are unchanged; their documentation points
to the copies maintained here. The CLI repository's existing examples remain
available for users of those earlier URLs.

Templates describe dependencies; they do not grant credentials, provider access
or permission to spend money. Engineering includes Pi-native packages and
explicit setup commands: read its trust and installation instructions first.
44 changes: 44 additions & 0 deletions workspaces/designer/.allagents/workspace.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
version: 2

repositories:
- path: .
description: Design project, source assets and editable deliverables
skills: false
# Keep Video Use's root skill and helpers in their original repository.
# Plugin discovery otherwise selects its nested Manim skill instead.
- path: sources/video-use
source: github
repo: browser-use/video-use
managed: clone
ref: main
description: Read-only upstream Video Use reference and video-editing helpers
skills: false

plugins:
- source: https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/tree/main/.claude
install: file
- source: https://github.com/remotion-dev/skills
install: file
- source: https://github.com/LottieFiles/motion-design-skill
install: file
- source: https://github.com/wuwangzhang1216/DirectorSKILL
install: file
- source: https://github.com/NousResearch/hermes-agent/tree/main/skills/creative/songwriting-and-ai-music
install: file
skills: [songwriting-and-ai-music]
- source: https://github.com/coreyhaines31/marketingskills
install: file
skills: [product-marketing, content-strategy, copywriting, ad-creative]
- source: https://github.com/JimLiu/baoyu-skills
install: file
skills: [baoyu-infographic, baoyu-comic]
- source: https://github.com/Leonxlnx/earshot
install: file
skills: [earshot]
- source: https://github.com/greensock/gsap-skills
install: file
skills: [gsap-core, gsap-timeline, gsap-scrolltrigger, gsap-react]
- productivity@allagentsdev/agent-plugins

clients:
- universal
45 changes: 45 additions & 0 deletions workspaces/designer/AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
# Designer

Design interfaces, direct films, edit recorded videos and develop marketing
creative. Keep editable sources and inspect the rendered result. Apply the
installed `write-naturally` skill to user-facing writing.

Read the project's brief, design system and references first. Choose one design
lead and the few specialist skills needed for the task. Read a skill before
using its scripts or following its production workflow.

| Work | Skill or source |
| --- | --- |
| Interfaces and design systems | `ui-ux-pro-max` |
| Story, shots, blocking and continuity | `cinematic-director` |
| Video composition and rendering | `remotion-best-practices` and its relevant specialist skill |
| Tutorial editing, retakes, captions and cut decisions | Read `sources/video-use/SKILL.md`; use its original helpers with FFmpeg |
| Timing, staging and choreography | `motion-design` |
| Interactive browser animation | `gsap-core`, `gsap-timeline`, `gsap-scrolltrigger`; `gsap-react` in React |
| Audio measurement and event analysis | `earshot` |
| Lyrics, song structure and music prompts | `songwriting-and-ai-music` |
| Positioning, campaigns and copy | `product-marketing`, `content-strategy`, `copywriting`, `ad-creative` |
| Illustrated explainers | `baoyu-infographic` or `baoyu-comic`, when requested |

The project root holds working material and deliverables. Treat
`sources/video-use/` as an unchanged upstream reference. Read its root skill
directly; AllAgents' plugin discovery would prefer the nested Manim skill.
Preserve source footage and keep narration, music, effects and captions editable.
Review cuts against picture and speech; silence alone is not a reason to cut.
Recalculate captions and chapters on the edited timeline.

For 3D work, use Blender and its original MCP bridge when installed. Start it
only for the active task and keep the bridge on loopback. In Remotion, derive
animation from the composition frame or seek a paused GSAP timeline so rendering
is deterministic. Inspect desktop/mobile layouts, keyboard interaction and
reduced-motion behavior for interface work.

Skills provide guidance; verify local tools and service authentication before
using them. Load credentials inside the API client from private runtime storage
or the owner's credential manager. Keep them out of chat, project `.env` files
and Git. This overrides upstream examples asking for pasted keys. Paid media
generation, transcription, public uploads and posting require explicit owner
authorization. Earshot's optional audio-LLM upload also needs consent.

Finish with editable sources, requested exports, checks performed and any
remaining limitations. Keep caches and large generated media outside Git.
86 changes: 86 additions & 0 deletions workspaces/designer/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
# Designer workspace

A project workspace for interface design, film direction, video editing, motion,
audio review and marketing creative. It composes original publisher skills and
keeps the Video Use editing skill with its upstream helpers.

## Create a workspace

```sh
allagents workspace init ./designer \
--from allagentsdev/agent-plugins/workspaces/designer
cd designer
printf '\n/sources/video-use/\n' >> .gitignore
allagents plugin list
```

Use AllAgents 1.23.0 or newer, Git and network access. The default `universal`
client installs portable skills into `.agents/skills/`. Clients such as Codex
and Pi can discover that directory. Select other clients with `--client` during
initialization when their own resource directories are needed.

The ignore entry keeps the upstream reference checkout outside project commits.
It appends to an existing `.gitignore`.

The template copies its [Designer guidance](AGENTS.md) into new workspaces while
preserving an existing `AGENTS.md`. In an existing project, incorporate the
relevant guidance into that file yourself. Installation does not start an agent
or create a separate authenticated bot.

## Skill stack

| Source | Purpose |
| --- | --- |
| [UI UX Pro Max](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) | Interface and design-system lead |
| [Remotion](https://github.com/remotion-dev/skills) | Composition, titles, overlays and rendering |
| [Motion Design](https://github.com/LottieFiles/motion-design-skill) | Timing, easing, staging and choreography |
| [DirectorSKILL](https://github.com/wuwangzhang1216/DirectorSKILL) | Story, shot coverage, blocking and continuity |
| [Video Use](https://github.com/browser-use/video-use) | Recorded footage, tutorial editing, transcripts and cut decisions |
| [Hermes songwriting](https://github.com/NousResearch/hermes-agent/tree/main/skills/creative/songwriting-and-ai-music) | Lyrics, song structure and music prompts |
| [Corey Haines marketing skills](https://github.com/coreyhaines31/marketingskills) | Four selected positioning, content, copy and ad skills |
| [Baoyu skills](https://github.com/JimLiu/baoyu-skills) | Infographics and comics |
| [Earshot](https://github.com/Leonxlnx/earshot) | Local audio measurements and model-assisted review |
| [Official GSAP skills](https://github.com/greensock/gsap-skills) | Core, timelines, ScrollTrigger and React |
| [Productivity](../../plugins/productivity) | Write Naturally |

Video Use has a root editing skill and a nested Manim skill. AllAgents' plugin
discovery prefers the nested directory, so this recipe instead clones the
original repository to `sources/video-use/` and points the agent to its root
`SKILL.md`. Its skill and helper bytes stay unchanged. The reference uses
`managed: clone`: AllAgents creates it when missing and does not pull it during
later updates. Review upstream changes before updating that checkout. Keep the
reference checkout and render caches out of your project's Git history.

## Software and accounts

Workspace initialization installs instructions and the Video Use reference. It
does not install media binaries, download audio models, authenticate services or
generate paid content.

| Primitive | Separate setup |
| --- | --- |
| FFmpeg and ffprobe | Install through your operating-system package manager |
| Remotion | Install Node.js and the project's Remotion/React packages; prepare its browser renderer |
| Video Use | Install Python and its declared dependencies; transcription needs ElevenLabs API access |
| GSAP | Install `gsap` and, for React projects, `@gsap/react` in the project |
| Earshot | Install the original CLI/MCP package and download its CLAP/AST models; analysis runs locally on CPU |
| Blender | Install Blender and the [original MCP bridge](https://github.com/ahujasid/mcp-for-blender) if needed; its bridge uses a normal Blender session and can run under Xvfb on Linux |
| Generated footage, music and voice | Configure Higgsfield, Suno and ElevenLabs separately through their official APIs or supported authenticated tools |

Earshot and the Blender bridge currently require different major versions of
Python's MCP package; use separate environments. GSAP requires no AI model.
Earshot's Gemini critique is optional and uploads audio only with consent.
For ElevenLabs API-key use, prefer its maintained official SDK; hosted MCP OAuth
is a separate connection. Keep credentials in private runtime storage and load
them inside the client process. Setup does not authorize paid generation,
transcription or publishing.

## Update

```sh
allagents update
```

This reconciles the declared plugin sources. It does not pull the Video Use
reference or install/update your project's media dependencies. Restart the agent
after skill changes and verify rendered output in the production toolchain.
57 changes: 57 additions & 0 deletions workspaces/engineering/.allagents/workspace.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
version: 2

setup:
- run: curl -fsSL https://herdr.dev/install.sh | sh
platforms: [linux, darwin]
- run: 'powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"'
platforms: [win32]

repositories: []

plugins:
# Enable the complete Compound Engineering plugin from its default branch.
- source: https://github.com/EveryInc/compound-engineering-plugin

# Preserve Matt's upstream composition by installing the selected capabilities
# with every helper skill they invoke. The explicit closure prevents unrelated
# additions from auto-enabling while keeping each selected workflow complete.
- source: https://github.com/mattpocock/skills
skills:
- engineering/wayfinder
- engineering/grill-with-docs
- engineering/improve-codebase-architecture
- engineering/domain-modeling
- engineering/research
- engineering/prototype
- engineering/codebase-design
- engineering/setup-matt-pocock-skills
- productivity/grilling

- source: https://github.com/NousResearch/hermes-agent
skills:
- research/llm-wiki

- source: https://github.com/herdrdev/herdr
skills:
- herdr

# Pi owns package installation and loading. Explicit client overrides keep
# these packages separate from the universal file-mode skills above.
# Save project trust and select native CE skills in Pi before initialization;
# see ../README.md. Portable CE files otherwise shadow the native skills.
# npm packages retain reviewed pins; Compound Engineering follows upstream.
- source: npm:pi-web-access@0.37.0
clients: [pi]
install: native
- source: git:github.com/EveryInc/compound-engineering-plugin
clients: [pi]
install: native
- source: npm:pi-subagents@0.76.1
clients: [pi]
install: native
- source: npm:pi-ask-user@0.16.0
clients: [pi]
install: native

clients:
- universal
Loading
Loading