Przejdź do treści
Biblioteka skilli
AI i agenci · Budowanie i kod

multi-harness-plugins

/multi-harness-plugins

Tworzy i sprawdza wieloplatformowe pluginy oraz skille, subagenty, hooki i konfiguracje MCP dla kilku narzędzi AI programistycznych.

Repozytorium
flow ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Tworzy i sprawdza wieloplatformowe pluginy oraz skille, subagenty, hooki i konfiguracje MCP dla kilku narzędzi AI programistycznych.

Oryginalny opis (EN)

Use when creating, structuring, or validating multi-harness plugins or project-local .agents/ skills, subagents, hooks, rules, and MCP configs across Google Antigravity, Claude Code, Codex CLI, Cursor, OpenCode, and VS Code.

Jak działa

  1. Project-Local Discovery Matrix (.agents/ & Repo-Local Configs)
  2. Workflow
  3. Guardrails
  4. References
  5. Validation
  6. Example
Sekcje z nagłówków SKILL.md, w oryginale · 59 linii, 830 słów
Podgląd SKILL.md
---
name: multi-harness-plugins
description: Use when creating, structuring, or validating multi-harness plugins or project-local .agents/ skills, subagents, hooks, rules, and MCP configs across Google Antigravity, Claude Code, Codex CLI, Cursor, OpenCode, and VS Code.
---

# Multi-Harness Plugins & Project-Local `.agents/` Architecture

Build and maintain skills, subagents, hooks, rules, and MCP configurations that work cleanly across **Google Antigravity (IDE & CLI)**, **Claude Code**, **Codex CLI**, **Cursor**, **OpenCode V2**, and **VS Code / GitHub Copilot**—both for **project-local `.agents/` folders** and **extension-wide plugins**.

## Project-Local Discovery Matrix (`.agents/` & Repo-Local Configs)

How each harness discovers project-local instructions, skills, subagents, hooks, and MCP servers inside a repository:

| Surface | Google Antigravity (`agy`) | Claude Code (`claude`) | Codex CLI (`codex`) | Cursor (`cursor`) | OpenCode V2 (`opencode`) | VS Code / Copilot (`code`) |
| --- | --- | --- | --- | --- | --- | --- |
| **Instructions** | `AGENTS.md`, `GEMINI.md`, `.agents/rules/*.md` | `AGENTS.md` (native; suppressed if `CLAUDE.md` exists without `@AGENTS.md`) | `AGENTS.md` (`AGENTS.override.md` wins; trusted projects) | `AGENTS.md`, `.cursor/rules/*.mdc` or `*.md` | `AGENTS.md` (walked from `cwd` to root; no `CLAUDE.md` fallback) | `AGENTS.md` (`chat.useAgentsMdFile: true`) |
| **Project Skills** | `.agents/skills/<name>/SKILL.md` | `.claude/skills/<name>/SKILL.md` (or symlinked to `.agents/skills/`) | `.agents/skills/<name>/SKILL.md` | `.agents/skills/`, `.cursor/skills/`, `.claude/skills/` | `.agents/skills/`, `.opencode/skills/`, `.claude/skills/` | `.agents/skills/`, `.github/skills/` |
| **Project Subagents** | `.agents/agents/<name>.md` (`agents/*/agent.md`) | `.claude/agents/<name>.md` | `.codex/agents/<name>.toml` (recursive in trusted projects) | `.cursor/agents/*.md`, `.claude/agents/*.md`, `.codex/agents/` | `.opencode/agents/*.md` or `ctx.agent.transform` in `.opencode/plugins/*.js` | `.github/agents/*.agent.md`, `.claude/agents/*.md` |
| **Project Hooks** | `.agents/hooks.json` (flat lifecycle array; nested tool matcher) | `.claude/settings.json` / `.claude/settings.local.json` (nested matchers) | `.codex/hooks.json` or `[hooks]` in `.codex/config.toml` (trusted projects) | `.cursor/hooks.json` (`version: 1`, camelCase events) | `.opencode/plugins/*.{ts,js}` (`ctx.session.hook("context", ...)`) | `.claude/settings.json`, `.github/hooks/*.json` |
| **Project MCP Config** | `.agents/mcp_config.json` (or `~/.gemini/antigravity/mcp_config.json`) | `.mcp.json` (`mcpServers` at repo root) | `.mcp.json` or `[mcp_servers.<name>]` in `.codex/config.toml` | `.cursor/mcp.json` (`mcpServers`; `${workspaceFolder}`) | `opencode.json` (`mcp.servers.<name>`) or `ctx.mcp.transform` | `.vscode/mcp.json` (`servers` object) |

## Workflow

1. **Choose the Target Scope**:
   - **Project-Local (`.agents/` inside a repository)**: Used by `/flow:setup`, `/flow:learn`, and repository maintainers to store `.agents/bundles/` knowledge, `.agents/skills/<domain>/` domain and review skills, `.agents/agents/<name>.md` subagents, `.codex/agents/<name>.toml` agents, and `.agents/mcp_config.json` / `.mcp.json` server definitions.
   - **Extension-Wide Plugin (Plugin Repository Root)**: Used when packaging reusable skills, subagents, hooks, rules, and MCP servers as an installable plugin across all six harnesses.
2. **Author Progressive-Disclosure Skills**:
   - Keep every `SKILL.md` concise (`<= 200` lines and strictly `< 24,000` bytes so Google Antigravity never truncates the bottom of the file).
   - Start `description` with `Use when ...` (`<= 500` characters) and avoid vague prefixes (`Auto-activate`, `Produces`, `Expert knowledge`, `Comprehensive`).
   - Put detailed schemas, checklists, and examples in `references/*.md` files linked from `SKILL.md`.
3. **Author Compatible Subagents**:
   - Format Markdown subagents (`agents/<name>.md` or `.agents/agents/<name>.md`) with `name`, `description`, `model: inherit`, `mainAgent: false`, `subagent: true`, `commandExecutionPolicy`, `skills: [...]`, and `readonly: true` + YAML list `disallowedTools` for read-only reviewers.
   - Use top-level H1 (`# `) section headings (`# Role & Identity`, `# Responsibilities`, `# Verification & Constraints`, `# Output Contract`) with `###` subsections so Antigravity splits sections into XML system-prompt blocks.
   - Pair Markdown subagents with `.codex/agents/<name>.toml` for Codex CLI.
4. **Keep Runtime Hooks Zero-Dependency & Cross-Platform**:
   - Do not require `python3`, `node`, or `jq` in `SessionStart` shell hooks (`agy` and `codex` ship as static native binaries).
   - Pair pure POSIX `sh` + `awk` (`hooks/<name>.sh`) with native PowerShell (`hooks/<name>.ps1`, `pwsh` / Windows PowerShell 5.1+) and `"commandWindows"` for Windows hosts, plus `.opencode/plugins/<name>.js` in native `node:fs` / `node:path`.
5. **Validate Structural Parity**:
   - Run `/flow:validate` to verify `SKILL.md` byte budgets, subagent frontmatter and H1 headings, hook schemas, and relative links.

## Guardrails

- **No Duplicate Surface Mirrors**: Never maintain `plugins/<name>/` mirrors, root `CLAUDE.md` files alongside `AGENTS.md` (breaks `claude plugin validate --strict` and double-loads with `AGENTS.md` in Cursor), `.github/agents/*.agent.md` copies, `.opencode/agents/*.md` copies, or `commands/` wrappers.
- **Strict `24 KB` `SKILL.md` Cap**: Never exceed `24,000` bytes in any `SKILL.md` file.
- **YAML List Tool Restrictions**: Always format `tools` and `disallowedTools` as YAML lists (`- Edit`), never comma-separated strings (`tools: Read, Grep` fails YAML unmarshaling in Antigravity and silently drops the subagent).
- **Short MCP Server & Tool Names**: Keep combined MCP tool names under `60` characters (`^[a-zA-Z0-9_-]+$`) so Cursor (`59`-char cap) and Antigravity (`64`-char cap on `mcp_<plugin>_<server>_<tool>`) never drop or truncate tools.

## References

- [Skills, Subagents, Local `.agents/`, & MCP Limits](references/skills-subagents-and-mcp-limits.md) — How each harness loads `.agents/` folders, local MCP configs (`.agents/mcp_config.json`, `.mcp.json`, `.cursor/mcp.json`, `.vscode/mcp.json`, `opencode.json`), H1 subagent sections, and Antigravity's Python `run_workflow` API.
- [Hooks & Runtime Portability](references/hooks-and-runtime-portability.md) — Project-local and plugin hook schemas (flat Antigravity lifecycle hooks vs. nested Claude/Codex matchers), stdout JSON keys, Cursor deduplication, and OpenCode V2 `setup(ctx)`.
- [Manifests & Single-Root Packaging](references/manifests-and-packaging.md) — Root layout and manifest schemas for `plugin.json`, `.claude-plugin/`, `.codex-plugin/`, `.cursor-plugin/`, `.agents/plugins/marketplace.json`, `package.json`, and OpenCode V2.

## Validation

- Confirm every `SKILL.md` has `name` and `description` (`Use when ...`, `<= 500` chars) and is `< 24,000` bytes.
- Confirm every subagent in `agents/*.md` or `.agents/agents/*.md` includes `model: inherit`, `mainAgent: false`, `subagent: true`, H1 (`# `) section headings, and YAML list `disallowedTools` on read-only agents.
- Confirm all relative Markdown links resolve on disk.

## Example

Invoke this skill when scaffolding project-local skills, subagents, hooks, or MCP configs under `.agents/` during `/flow:setup` or `/flow:learn`, or when authoring an extension-wide multi-harness plugin.
Pliki w paczce (4)
  • SKILL.md 7 KB
  • references/hooks-and-runtime-portability.md 8 KB
  • references/manifests-and-packaging.md 6 KB
  • references/skills-subagents-and-mcp-limits.md 12 KB

Wersje

W bazie nie ma innych skilli o nazwie multi-harness-plugins.

Migawka bazy z 13.11.2026 · wersja paczki 157dd0b59d92 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100claude-automation-recommender
    Analizuje bazę kodu i proponuje automatyzacje Claude Code: hooki, subagenty, skille, pluginy i serwery MCP.
  • 90agent-tooling-audit
    Sprawdza, które skille, wtyczki, serwery MCP i hooki pasują do projektu i wskazuje, czego brakuje w konfiguracji agenta.
  • 100claude-automation-recommender
    Analizuje bazę kodu i rekomenduje automatyzacje Claude Code: hooki, subagenty, skille, pluginy i serwery MCP, przy optymalizacji konfiguracji.
  • 100claude-automation-recommender
    Analizuje bazę kodu i rekomenduje automatyzacje Claude Code: hooki, subagenty, skille, pluginy i serwery MCP, przy optymalizacji konfiguracji.
  • 100claude-automation-recommender
    Analizuje bazę kodu i rekomenduje automatyzacje Claude Code: hooki, subagenty, skille, pluginy i serwery MCP, przy optymalizacji konfiguracji.
  • 90Creating New Plugins
    Prowadzi przez tworzenie nowych pluginów Claude Code i rejestrowanie ich w marketplace: komendy, skille, hooki i serwery MCP.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.