opencode-skills-collection 3.0.39 → 3.0.41
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bundled-skills/.antigravity-install-manifest.json +6 -1
- package/bundled-skills/2slides-ppt-generator/SKILL.md +12 -2
- package/bundled-skills/2slides-ppt-generator/requirements.txt +1 -0
- package/bundled-skills/2slides-ppt-generator/scripts/create_pdf_slides.py +1 -1
- package/bundled-skills/accesslint-diff/SKILL.md +4 -1
- package/bundled-skills/article-illustrations/SKILL.md +159 -0
- package/bundled-skills/cv-generator/SKILL.md +874 -0
- package/bundled-skills/docs/integrations/jetski-cortex.md +3 -3
- package/bundled-skills/docs/integrations/jetski-gemini-loader/README.md +1 -1
- package/bundled-skills/docs/maintainers/repo-growth-seo.md +3 -3
- package/bundled-skills/docs/maintainers/skills-update-guide.md +1 -1
- package/bundled-skills/docs/sources/sources.md +1 -0
- package/bundled-skills/docs/users/bundles.md +1 -1
- package/bundled-skills/docs/users/claude-code-skills.md +1 -1
- package/bundled-skills/docs/users/gemini-cli-skills.md +1 -1
- package/bundled-skills/docs/users/getting-started.md +1 -1
- package/bundled-skills/docs/users/kiro-integration.md +1 -1
- package/bundled-skills/docs/users/usage.md +4 -4
- package/bundled-skills/docs/users/visual-guide.md +4 -4
- package/bundled-skills/examprep-ai/SKILL.md +8 -0
- package/bundled-skills/hugging-face-cli/SKILL.md +2 -2
- package/bundled-skills/open-dynamic-workflows/SKILL.md +101 -0
- package/bundled-skills/permission-manager/README.md +1 -1
- package/bundled-skills/permission-manager/SKILL.md +2 -1
- package/bundled-skills/polis-protocol/SKILL.md +13 -4
- package/bundled-skills/runapi-cli/SKILL.md +140 -0
- package/bundled-skills/schema-markup-generator/SKILL.md +2 -1
- package/bundled-skills/smart-git-automation/SKILL.md +4 -2
- package/bundled-skills/user-thoughts/scripts/common.py +93 -6
- package/bundled-skills/user-thoughts/scripts/ignore_ops.py +20 -20
- package/bundled-skills/user-thoughts/scripts/init.py +3 -1
- package/bundled-skills/user-thoughts/scripts/show_mdbase.py +5 -5
- package/bundled-skills/user-thoughts/scripts/show_raw.py +3 -3
- package/bundled-skills/user-thoughts/scripts/sortin.py +37 -26
- package/bundled-skills/user-thoughts/scripts/status.py +8 -8
- package/bundled-skills/user-thoughts/scripts/write_raw.py +20 -11
- package/bundled-skills/vercel-cli-with-tokens/SKILL.md +15 -12
- package/bundled-skills/video-content-extractor/SKILL.md +103 -0
- package/package.json +1 -1
- package/skills_index.json +119 -7
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Jetski/Cortex + Gemini Integration Guide
|
|
3
|
-
description: "Use antigravity-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1,
|
|
3
|
+
description: "Use antigravity-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1,525+ skills."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Jetski/Cortex + Gemini: safe integration with 1,
|
|
6
|
+
# Jetski/Cortex + Gemini: safe integration with 1,525+ skills
|
|
7
7
|
|
|
8
8
|
This guide shows how to integrate the `antigravity-awesome-skills` repository with an agent based on **Jetski/Cortex + Gemini** (or similar frameworks) **without exceeding the model context window**.
|
|
9
9
|
|
|
@@ -23,7 +23,7 @@ Never do:
|
|
|
23
23
|
- concatenate all `SKILL.md` content into a single system prompt;
|
|
24
24
|
- re-inject the entire library for **every** request.
|
|
25
25
|
|
|
26
|
-
With 1,
|
|
26
|
+
With 1,525+ skills, this approach fills the context window before user messages are even added, causing truncation.
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
|
@@ -21,7 +21,7 @@ This example shows one way to integrate **antigravity-awesome-skills** with a Je
|
|
|
21
21
|
- How to enforce a **maximum number of skills per turn** via `maxSkillsPerTurn`.
|
|
22
22
|
- How to choose whether to **truncate or error** when too many skills are requested via `overflowBehavior`.
|
|
23
23
|
|
|
24
|
-
This pattern avoids context overflow when you have 1,
|
|
24
|
+
This pattern avoids context overflow when you have 1,525+ skills installed.
|
|
25
25
|
|
|
26
26
|
Manifest contract references:
|
|
27
27
|
|
|
@@ -6,7 +6,7 @@ This document keeps the repository's GitHub-facing discovery copy aligned with t
|
|
|
6
6
|
|
|
7
7
|
Preferred positioning:
|
|
8
8
|
|
|
9
|
-
> Installable GitHub library of 1,
|
|
9
|
+
> Installable GitHub library of 1,525+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.
|
|
10
10
|
|
|
11
11
|
Key framing:
|
|
12
12
|
|
|
@@ -20,7 +20,7 @@ Key framing:
|
|
|
20
20
|
|
|
21
21
|
Preferred description:
|
|
22
22
|
|
|
23
|
-
> Installable GitHub library of 1,
|
|
23
|
+
> Installable GitHub library of 1,525+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
|
|
24
24
|
|
|
25
25
|
Preferred homepage:
|
|
26
26
|
|
|
@@ -28,7 +28,7 @@ Preferred homepage:
|
|
|
28
28
|
|
|
29
29
|
Preferred social preview:
|
|
30
30
|
|
|
31
|
-
- use a clean preview image that says `1,
|
|
31
|
+
- use a clean preview image that says `1,525+ Agentic Skills`;
|
|
32
32
|
- mention Claude Code, Cursor, Codex CLI, and Gemini CLI;
|
|
33
33
|
- avoid dense text and tiny logos that disappear in social cards.
|
|
34
34
|
|
|
@@ -72,7 +72,7 @@ The update process refreshes:
|
|
|
72
72
|
- Canonical skills index (`skills_index.json`)
|
|
73
73
|
- Compatibility mirror (`data/skills_index.json`)
|
|
74
74
|
- Web app skills data (`apps\web-app\public\skills.json`)
|
|
75
|
-
- All 1,
|
|
75
|
+
- All 1,525+ skills from the skills directory
|
|
76
76
|
|
|
77
77
|
## When to Update
|
|
78
78
|
|
|
@@ -11,6 +11,7 @@ If you recognize your work here and it is not properly attributed, please open a
|
|
|
11
11
|
| `burp-suite-testing` | [PortSwigger](https://portswigger.net/burp) | N/A | Usage guide only (no binary). |
|
|
12
12
|
| `crewai` | [CrewAI](https://github.com/joaomdmoura/crewAI) | MIT | Framework guides. |
|
|
13
13
|
| `hasdata`, `hasdata-cli` | [HasData CLI](https://github.com/HasData/hasdata-cli) | MIT | Official HasData API and CLI guidance. |
|
|
14
|
+
| `runapi-cli` | [RunAPI CLI Skill](https://github.com/runapi-ai/cli-skill) | Apache-2.0 | Official RunAPI CLI skill for generating AI images, videos, and music/audio, plus other model API jobs. |
|
|
14
15
|
| `langgraph` | [LangGraph](https://github.com/langchain-ai/langgraph) | MIT | Framework guides. |
|
|
15
16
|
| `react-patterns` | [React Docs](https://react.dev/) | CC-BY | Official patterns. |
|
|
16
17
|
| **All Official Skills** | [Anthropic / Google / OpenAI / Microsoft / Supabase / Apify / Vercel Labs] | Proprietary | Usage encouraged by vendors. |
|
|
@@ -12,7 +12,7 @@ Install the library into Claude Code, then invoke focused skills directly in the
|
|
|
12
12
|
|
|
13
13
|
## Why use this repo for Claude Code
|
|
14
14
|
|
|
15
|
-
- It includes 1,
|
|
15
|
+
- It includes 1,525+ skills instead of a narrow single-domain starter pack.
|
|
16
16
|
- It supports the standard `.claude/skills/` path and the Claude Code plugin marketplace flow.
|
|
17
17
|
- It also ships generated bundle plugins so teams can install focused packs like `Essentials` or `Security Developer` from the marketplace metadata.
|
|
18
18
|
- It includes onboarding docs, bundles, and workflows so new users do not need to guess where to begin.
|
|
@@ -12,7 +12,7 @@ Install into the Gemini skills path, then ask Gemini to apply one skill at a tim
|
|
|
12
12
|
|
|
13
13
|
- It installs directly into the expected Gemini skills path.
|
|
14
14
|
- It includes both core software engineering skills and deeper agent/LLM-oriented skills.
|
|
15
|
-
- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,
|
|
15
|
+
- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,525+ files.
|
|
16
16
|
- It is useful whether you want a broad internal skill library or a single repo to test many workflows quickly.
|
|
17
17
|
|
|
18
18
|
## Install Gemini CLI Skills
|
|
@@ -18,7 +18,7 @@ Kiro is AWS's agentic AI IDE that combines:
|
|
|
18
18
|
|
|
19
19
|
Kiro's agentic capabilities are enhanced by skills that provide:
|
|
20
20
|
|
|
21
|
-
- **Domain expertise** across 1,
|
|
21
|
+
- **Domain expertise** across 1,525+ specialized areas
|
|
22
22
|
- **Best practices** from Anthropic, OpenAI, Google, Microsoft, and AWS
|
|
23
23
|
- **Workflow automation** for common development tasks
|
|
24
24
|
- **AWS-specific patterns** for serverless, infrastructure, and cloud architecture
|
|
@@ -14,7 +14,7 @@ If you came in through a **Claude Code** or **Codex** plugin instead of a full l
|
|
|
14
14
|
|
|
15
15
|
When you ran `npx antigravity-awesome-skills` or cloned the repository, you:
|
|
16
16
|
|
|
17
|
-
✅ **Downloaded 1,
|
|
17
|
+
✅ **Downloaded 1,525+ skill files** to your computer (default: `~/.agents/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)
|
|
18
18
|
✅ **Made them available** to your AI assistant
|
|
19
19
|
❌ **Did NOT enable them all automatically** (they're just sitting there, waiting)
|
|
20
20
|
|
|
@@ -34,7 +34,7 @@ Bundles are **curated groups** of skills organized by role. They help you decide
|
|
|
34
34
|
|
|
35
35
|
**Analogy:**
|
|
36
36
|
|
|
37
|
-
- You installed a toolbox with 1,
|
|
37
|
+
- You installed a toolbox with 1,525+ tools (✅ done)
|
|
38
38
|
- Bundles are like **labeled organizer trays** saying: "If you're a carpenter, start with these 10 tools"
|
|
39
39
|
- You can either **pick skills from the tray** or install that tray as a focused marketplace bundle plugin
|
|
40
40
|
|
|
@@ -212,7 +212,7 @@ Let's actually use a skill right now. Follow these steps:
|
|
|
212
212
|
|
|
213
213
|
## Step 5: Picking Your First Skills (Practical Advice)
|
|
214
214
|
|
|
215
|
-
Don't try to use all 1,
|
|
215
|
+
Don't try to use all 1,525+ skills at once. Here's a sensible approach:
|
|
216
216
|
|
|
217
217
|
If you want a tool-specific starting point before choosing skills, use:
|
|
218
218
|
|
|
@@ -343,7 +343,7 @@ Usually no, but if your AI doesn't recognize a skill:
|
|
|
343
343
|
|
|
344
344
|
### "Can I load all skills into the model at once?"
|
|
345
345
|
|
|
346
|
-
No. Even though you have 1,
|
|
346
|
+
No. Even though you have 1,525+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
|
|
347
347
|
|
|
348
348
|
The intended pattern is:
|
|
349
349
|
|
|
@@ -34,7 +34,7 @@ antigravity-awesome-skills/
|
|
|
34
34
|
├── 📄 CONTRIBUTING.md ← Contributor workflow
|
|
35
35
|
├── 📄 CATALOG.md ← Full generated catalog
|
|
36
36
|
│
|
|
37
|
-
├── 📁 skills/ ← 1,
|
|
37
|
+
├── 📁 skills/ ← 1,525+ skills live here
|
|
38
38
|
│ │
|
|
39
39
|
│ ├── 📁 brainstorming/
|
|
40
40
|
│ │ └── 📄 SKILL.md ← Skill definition
|
|
@@ -47,7 +47,7 @@ antigravity-awesome-skills/
|
|
|
47
47
|
│ │ └── 📁 2d-games/
|
|
48
48
|
│ │ └── 📄 SKILL.md ← Nested skills also supported
|
|
49
49
|
│ │
|
|
50
|
-
│ └── ... (1,
|
|
50
|
+
│ └── ... (1,525+ total)
|
|
51
51
|
│
|
|
52
52
|
├── 📁 apps/
|
|
53
53
|
│ └── 📁 web-app/ ← Interactive browser
|
|
@@ -100,7 +100,7 @@ antigravity-awesome-skills/
|
|
|
100
100
|
|
|
101
101
|
```
|
|
102
102
|
┌─────────────────────────┐
|
|
103
|
-
│ 1,
|
|
103
|
+
│ 1,525+ SKILLS │
|
|
104
104
|
└────────────┬────────────┘
|
|
105
105
|
│
|
|
106
106
|
┌────────────────────────┼────────────────────────┐
|
|
@@ -201,7 +201,7 @@ If you want a workspace-style manual install instead, cloning into `.agent/skill
|
|
|
201
201
|
│ ├── 📁 brainstorming/ │
|
|
202
202
|
│ ├── 📁 stripe-integration/ │
|
|
203
203
|
│ ├── 📁 react-best-practices/ │
|
|
204
|
-
│ └── ... (1,
|
|
204
|
+
│ └── ... (1,525+ total) │
|
|
205
205
|
└─────────────────────────────────────────┘
|
|
206
206
|
```
|
|
207
207
|
|
|
@@ -19,6 +19,14 @@ tags:
|
|
|
19
19
|
|
|
20
20
|
# ExamPrep AI
|
|
21
21
|
|
|
22
|
+
## When to Use
|
|
23
|
+
|
|
24
|
+
Use this skill when you need to:
|
|
25
|
+
- Convert a syllabus, past papers, or study notes into a prioritized roadmap.
|
|
26
|
+
- Focus on specific types of exam questions (Theory, Numerical, MCQ, Coding, Lab).
|
|
27
|
+
- Create flashcards, predicted exam papers, or check your overall exam readiness.
|
|
28
|
+
- Perform last-minute revision or deep-dive into important exam topics.
|
|
29
|
+
|
|
22
30
|
## 🎯 Selective Reading Rule — Read ONLY the section matching the request
|
|
23
31
|
|
|
24
32
|
| What the student asks for | Jump to |
|
|
@@ -6,7 +6,7 @@ risk: unknown
|
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
Install by downloading the installer script first, reviewing it, and then running it locally. Example:
|
|
9
|
-
`curl -LsSf https://hf.co/cli/install.sh -o /
|
|
9
|
+
`tmpdir="$(mktemp -d)" && trap 'rm -rf "$tmpdir"' EXIT && curl -LsSf https://hf.co/cli/install.sh -o "$tmpdir/hf-install.sh" && less "$tmpdir/hf-install.sh" && bash "$tmpdir/hf-install.sh"`
|
|
10
10
|
|
|
11
11
|
## When to Use
|
|
12
12
|
Use this skill when you need the `hf` CLI for Hub authentication, downloads, uploads, repo management, or basic compute operations.
|
|
@@ -182,7 +182,7 @@ Generated with `huggingface_hub v1.8.0`. Run `hf skills add --force` to regenera
|
|
|
182
182
|
To mount Hub repositories or buckets as local filesystems — no download, no copy, no waiting — use `hf-mount`. Files are fetched on demand. GitHub: https://github.com/huggingface/hf-mount
|
|
183
183
|
|
|
184
184
|
Install by downloading the installer locally, reviewing it, and then running it. Example:
|
|
185
|
-
`curl -fsSL https://raw.githubusercontent.com/huggingface/hf-mount/main/install.sh -o /
|
|
185
|
+
`tmpdir="$(mktemp -d)" && trap 'rm -rf "$tmpdir"' EXIT && curl -fsSL https://raw.githubusercontent.com/huggingface/hf-mount/main/install.sh -o "$tmpdir/hf-mount-install.sh" && less "$tmpdir/hf-mount-install.sh" && sh "$tmpdir/hf-mount-install.sh"`
|
|
186
186
|
|
|
187
187
|
Some command examples:
|
|
188
188
|
- `hf-mount start repo openai-community/gpt2 /tmp/gpt2` — mount a repo (read-only)
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: open-dynamic-workflows
|
|
3
|
+
description: "Plan, orchestrate, and adversarially verify parallel AI coding agents with a dynamic multi-agent workflow engine."
|
|
4
|
+
category: ai-agents
|
|
5
|
+
risk: critical
|
|
6
|
+
source: community
|
|
7
|
+
source_repo: Suraj1235/open-dynamic-workflows
|
|
8
|
+
source_type: community
|
|
9
|
+
date_added: "2026-06-06"
|
|
10
|
+
author: Suraj1235
|
|
11
|
+
tags: [multi-agent, orchestration, workflow, adversarial-verification, coding-agents]
|
|
12
|
+
tools: [claude, cursor, codex, gemini, antigravity]
|
|
13
|
+
# Optional: declare the upstream license if source_repo is set
|
|
14
|
+
license: "MIT"
|
|
15
|
+
license_source: "https://github.com/Suraj1235/open-dynamic-workflows/blob/main/LICENSE"
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
# Open Dynamic Workflows
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
Open Dynamic Workflows (ODW) is an open-source dynamic multi-agent workflow engine for AI coding agents such as OpenCode, Codex, Antigravity, and VS Code. It lets you plan a task, orchestrate multiple agents working in parallel, and adversarially verify their output before it lands. ODW ships a Codex/Antigravity skill folder (`SKILL.md` plus a daemon bridge) and an OpenCode plugin, and it is bring-your-own-model (Anthropic, OpenAI-compatible, or Ollama). This skill is adapted from the community project at `Suraj1235/open-dynamic-workflows`.
|
|
23
|
+
|
|
24
|
+
## When to Use This Skill
|
|
25
|
+
|
|
26
|
+
- Use when you need to decompose a coding task into independent subtasks and run multiple agents in parallel.
|
|
27
|
+
- Use when working across more than one AI coding tool (OpenCode, Codex, Antigravity, VS Code) and want a single orchestration layer.
|
|
28
|
+
- Use when the user asks for adversarial review or verification of agent-generated changes before merging.
|
|
29
|
+
|
|
30
|
+
## How It Works
|
|
31
|
+
|
|
32
|
+
### Step 1: Plan
|
|
33
|
+
|
|
34
|
+
ODW takes a high-level goal and produces a dynamic workflow graph of subtasks, identifying which can run in parallel and which have dependencies.
|
|
35
|
+
|
|
36
|
+
### Step 2: Orchestrate
|
|
37
|
+
|
|
38
|
+
The engine dispatches subtasks to parallel agents through the OpenCode plugin or the Codex/Antigravity daemon bridge, using your configured model provider (Anthropic, OpenAI-compatible, or Ollama).
|
|
39
|
+
|
|
40
|
+
### Step 3: Adversarially Verify
|
|
41
|
+
|
|
42
|
+
Completed work is routed through an adversarial verification pass that challenges the output before results are synthesized and returned.
|
|
43
|
+
|
|
44
|
+
## Examples
|
|
45
|
+
|
|
46
|
+
### Example 1: Run a parallel workflow
|
|
47
|
+
|
|
48
|
+
ODW is installed from source (clone the repo, then `npm install`). The CLI is
|
|
49
|
+
`odw-daemon` — run it as `npm run odw -- <args>` from inside the repo, or as
|
|
50
|
+
`npx odw-daemon <args>` / a global `odw-daemon` if you link the bin.
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
# Configure your model provider (bring-your-own-model)
|
|
54
|
+
export ANTHROPIC_API_KEY=... # or an OpenAI-compatible / Ollama endpoint
|
|
55
|
+
|
|
56
|
+
# One-time setup: generate ~/.odw/config.json
|
|
57
|
+
npm run setup
|
|
58
|
+
|
|
59
|
+
# Start the local workflow daemon (once)
|
|
60
|
+
npm run odw -- start
|
|
61
|
+
|
|
62
|
+
# Plan, orchestrate, and verify a task across parallel agents
|
|
63
|
+
npm run odw -- run --prompt "refactor the auth module and add tests"
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### Example 2: Use the Codex/Antigravity skill bridge
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
# ODW ships a SKILL.md + daemon bridge consumed by Codex / Antigravity.
|
|
70
|
+
# Start the daemon, then run a saved orchestration script through it:
|
|
71
|
+
npm run odw -- start
|
|
72
|
+
npm run odw -- run --script examples/workflows/studio-prime.workflow.js --cwd .
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
## Best Practices
|
|
76
|
+
|
|
77
|
+
- ✅ Scope each subtask so agents can run without shared state.
|
|
78
|
+
- ✅ Keep the adversarial verification pass enabled before merging agent output.
|
|
79
|
+
- ❌ Don't run interdependent subtasks in parallel without declaring their dependencies.
|
|
80
|
+
- ❌ Don't commit provider API keys; use environment variables or a secrets manager.
|
|
81
|
+
|
|
82
|
+
## Limitations
|
|
83
|
+
|
|
84
|
+
- This skill does not replace environment-specific validation, testing, or expert review.
|
|
85
|
+
- Stop and ask for clarification if required inputs, permissions, or safety boundaries are missing.
|
|
86
|
+
|
|
87
|
+
## Security & Safety Notes
|
|
88
|
+
|
|
89
|
+
- ODW executes agent-generated code and shell commands; run it only in an authorized, local, or sandboxed environment.
|
|
90
|
+
- Model provider credentials (Anthropic / OpenAI-compatible / Ollama) must be supplied via environment variables, never committed to source.
|
|
91
|
+
- Review adversarial-verification output before applying changes to a production branch.
|
|
92
|
+
|
|
93
|
+
## Common Pitfalls
|
|
94
|
+
|
|
95
|
+
- **Problem:** Parallel agents collide on the same files.
|
|
96
|
+
**Solution:** Give each subtask exclusive file/module ownership and run conflicting tasks sequentially.
|
|
97
|
+
|
|
98
|
+
## Related Skills
|
|
99
|
+
|
|
100
|
+
- `@multi-agent-orchestration` - When coordinating multiple agents on one goal.
|
|
101
|
+
- `@code-review` - How adversarial verification complements human review.
|
|
@@ -18,5 +18,5 @@ Use this when optimizing opencode's permission settings, reviewing allowed comma
|
|
|
18
18
|
|
|
19
19
|
- **Config review**: Loads `~/.config/opencode/opencode.json` or project-level config
|
|
20
20
|
- **Permission summary**: Identifies currently allowed commands and skill permissions
|
|
21
|
-
- **Safe commands**: Suggests read-only commands
|
|
21
|
+
- **Safe commands**: Suggests reviewed read-only commands such as `git status --short`, `git log --oneline`, `rg`, `grep`, and `cat`; broad trailing wildcards need manual review.
|
|
22
22
|
- **Change application**: Edits config to add/remove permission entries, validates JSON
|
|
@@ -33,7 +33,8 @@ Complements opencode's built-in allow/deny/ask permissions by auditing current c
|
|
|
33
33
|
|
|
34
34
|
## Key Rules
|
|
35
35
|
- Never allow commands that modify files, commit, push, or change system state
|
|
36
|
-
-
|
|
36
|
+
- Prefer exact command entries such as `git status --short`, `git diff --stat`, and `ls -la`
|
|
37
|
+
- Avoid trailing wildcards such as `git status*` unless the expanded command family has been manually reviewed as read-only
|
|
37
38
|
- Confirm with user before modifying permission config
|
|
38
39
|
- Distinguish between bash command permissions and skill permissions
|
|
39
40
|
- Keep config organized: group related commands together
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: polis-protocol
|
|
3
3
|
description: "Coordinate multi-vendor AI agents as a self-improving team — a learning router assigns work by track record and citizens can amend the protocol's own rules."
|
|
4
4
|
category: orchestration
|
|
5
|
-
risk:
|
|
5
|
+
risk: critical
|
|
6
6
|
source: community
|
|
7
7
|
source_repo: yehudalevy-collab/polis-protocol
|
|
8
8
|
source_type: community
|
|
@@ -12,6 +12,10 @@ tags: [multi-agent, coordination, routing, orchestration, governance, vendor-agn
|
|
|
12
12
|
tools: [claude, cursor, gemini, codex, antigravity]
|
|
13
13
|
license: "MIT"
|
|
14
14
|
license_source: "https://github.com/yehudalevy-collab/polis-protocol/blob/main/LICENSE"
|
|
15
|
+
plugin:
|
|
16
|
+
targets:
|
|
17
|
+
codex: blocked
|
|
18
|
+
claude: blocked
|
|
15
19
|
---
|
|
16
20
|
|
|
17
21
|
# Polis Protocol — a team of agents that develops
|
|
@@ -33,11 +37,13 @@ In Antigravity specifically, this turns Manager View's fixed pipeline into a tea
|
|
|
33
37
|
|
|
34
38
|
### Step 1: Found a polis
|
|
35
39
|
|
|
36
|
-
Clone the repo and run the scaffolder directly (review `install.sh` first if you prefer the one-line installer):
|
|
40
|
+
Clone a reviewed revision of the repo and run the scaffolder directly (review `install.sh` first if you prefer the one-line installer):
|
|
37
41
|
|
|
38
42
|
```bash
|
|
39
43
|
git clone https://github.com/yehudalevy-collab/polis-protocol.git
|
|
40
|
-
|
|
44
|
+
cd polis-protocol
|
|
45
|
+
git checkout <reviewed-commit-sha>
|
|
46
|
+
python3 scripts/init_polis.py \
|
|
41
47
|
--project-root . \
|
|
42
48
|
--agent-id gemini-antigravity-yourproject \
|
|
43
49
|
--vendor google --model gemini-3 --tool antigravity
|
|
@@ -68,7 +74,9 @@ A settled contract files a lesson; `--reconcile` folds it into `routing_stats.ym
|
|
|
68
74
|
|
|
69
75
|
```bash
|
|
70
76
|
git clone https://github.com/yehudalevy-collab/polis-protocol.git
|
|
71
|
-
cd polis-protocol
|
|
77
|
+
cd polis-protocol
|
|
78
|
+
git checkout <reviewed-commit-sha>
|
|
79
|
+
bash scripts/demo.sh
|
|
72
80
|
```
|
|
73
81
|
|
|
74
82
|
The router recommends Gemini for a Spanish-translation contract — because settled work taught it she has the best record on that tag, not because anyone reassigned it.
|
|
@@ -91,3 +99,4 @@ python3 scripts/route_contract.py --polis-root examples/research-team/_polis \
|
|
|
91
99
|
- Routing quality depends on accurate citizen capability cards and enough settled work history to learn from.
|
|
92
100
|
- The protocol coordinates agent work but does not replace review, tests, or explicit maintainer approval.
|
|
93
101
|
- Multi-agent voting and amendments can add process overhead for small, single-owner tasks.
|
|
102
|
+
- The upstream scripts are external code; pin to a reviewed commit and run `--dry-run` before allowing writes to a project.
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: runapi-cli
|
|
3
|
+
description: Generate AI images, videos, and music/audio from agents using the RunAPI CLI.
|
|
4
|
+
category: development
|
|
5
|
+
risk: critical
|
|
6
|
+
source: official
|
|
7
|
+
source_repo: runapi-ai/cli-skill
|
|
8
|
+
source_type: official
|
|
9
|
+
date_added: "2026-06-07"
|
|
10
|
+
author: runapi-ai
|
|
11
|
+
tags: [runapi, cli, models, automation, codex, claude, gemini]
|
|
12
|
+
tools: [claude, codex, gemini, cursor, antigravity]
|
|
13
|
+
license: "Apache-2.0"
|
|
14
|
+
license_source: "https://github.com/runapi-ai/cli-skill/blob/main/LICENSE"
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# RunAPI CLI
|
|
18
|
+
|
|
19
|
+
## Overview
|
|
20
|
+
|
|
21
|
+
The `runapi` CLI is the execution layer for RunAPI model tasks. Use it when an agent needs to generate AI images, videos, or music/audio, run a one-off model job, pass a JSON request body, wait for an async task, or script RunAPI from a terminal, server, or CI job.
|
|
22
|
+
|
|
23
|
+
Source repository: [github.com/runapi-ai/cli-skill](https://github.com/runapi-ai/cli-skill) (Apache-2.0)
|
|
24
|
+
|
|
25
|
+
## When to Use This Skill
|
|
26
|
+
|
|
27
|
+
- Use when the user asks to run a RunAPI model from an agent.
|
|
28
|
+
- Use when the user needs to inspect RunAPI CLI auth or account status.
|
|
29
|
+
- Use when the user wants to pass JSON request bodies to RunAPI services.
|
|
30
|
+
- Use when the user wants to submit async RunAPI tasks and wait for completion.
|
|
31
|
+
- Use when the user wants to install the RunAPI CLI on a local machine, server, or CI runner.
|
|
32
|
+
|
|
33
|
+
## Install
|
|
34
|
+
|
|
35
|
+
### macOS / Linux
|
|
36
|
+
|
|
37
|
+
```shell
|
|
38
|
+
brew install runapi-ai/tap/runapi
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
### Server / CI
|
|
42
|
+
|
|
43
|
+
Download the installer, inspect it, then run it locally.
|
|
44
|
+
|
|
45
|
+
```shell
|
|
46
|
+
curl -fsSL https://runapi.ai/cli/install.sh -o runapi-install.sh
|
|
47
|
+
less runapi-install.sh
|
|
48
|
+
sh runapi-install.sh
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
To pin a specific version:
|
|
52
|
+
|
|
53
|
+
```shell
|
|
54
|
+
sh runapi-install.sh --version v0.1.0
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
The installer detects OS and architecture, verifies the SHA-256 checksum from `https://runapi.ai/cli/latest.json`, and refuses to write the binary if verification fails.
|
|
58
|
+
|
|
59
|
+
## Authentication
|
|
60
|
+
|
|
61
|
+
Treat RunAPI authentication and generation as security-sensitive: commands can call remote services, consume credits, and expose account state. Review installer scripts before running them and keep API keys in environment variables or stdin, not shell history.
|
|
62
|
+
|
|
63
|
+
Check the current state first:
|
|
64
|
+
|
|
65
|
+
```shell
|
|
66
|
+
runapi auth status
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
| Source | How |
|
|
70
|
+
|---|---|
|
|
71
|
+
| Environment | Read `RUNAPI_API_KEY` from the environment |
|
|
72
|
+
| Saved config | `printf '%s' "$RUNAPI_API_KEY" \| runapi auth import-token --token -` |
|
|
73
|
+
| Browser login | `runapi login` only when the user explicitly wants browser auth |
|
|
74
|
+
|
|
75
|
+
`RUNAPI_BASE_URL` overrides the default base URL.
|
|
76
|
+
|
|
77
|
+
Avoid passing secrets directly in command arguments. Prefer `RUNAPI_API_KEY` or stdin token import with `--token -`.
|
|
78
|
+
|
|
79
|
+
## Discover Services, Commands, and Fields
|
|
80
|
+
|
|
81
|
+
The CLI is JSON-first. Every service exposes typed commands, and each command documents its request fields through `--help`. Inspect command help before composing a request.
|
|
82
|
+
|
|
83
|
+
```shell
|
|
84
|
+
runapi --help
|
|
85
|
+
runapi suno --help
|
|
86
|
+
runapi suno text-to-music --help
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## Run a Model
|
|
90
|
+
|
|
91
|
+
Pass the request body as JSON through `--input-file`, `--input`, or stdin. The default flow is synchronous and polls until the task completes.
|
|
92
|
+
|
|
93
|
+
```shell
|
|
94
|
+
runapi suno text-to-music --input-file request.json
|
|
95
|
+
|
|
96
|
+
runapi suno text-to-music --async --input-file request.json
|
|
97
|
+
runapi wait <task-id> --service suno --action text-to-music
|
|
98
|
+
|
|
99
|
+
runapi get <task-id> --service suno --action text-to-music
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
JSON responses go to stdout; progress lines go to stderr. Pipe to `jq` for downstream parsing.
|
|
103
|
+
|
|
104
|
+
## Account
|
|
105
|
+
|
|
106
|
+
```shell
|
|
107
|
+
runapi account info
|
|
108
|
+
runapi account balance
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## Install the Skill Into Another Agent Runtime
|
|
112
|
+
|
|
113
|
+
```shell
|
|
114
|
+
runapi agent install-skill --target claude
|
|
115
|
+
runapi agent install-skill --target codex
|
|
116
|
+
runapi agent install-skill --target gemini
|
|
117
|
+
runapi agent install-skill --target openclaw
|
|
118
|
+
runapi agent list-targets
|
|
119
|
+
runapi agent install-skill --target-dir <path>
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Limitations
|
|
123
|
+
|
|
124
|
+
- RunAPI model calls require a valid RunAPI account or API key.
|
|
125
|
+
- Some model tasks are long-running and should use `--async` plus `runapi wait`.
|
|
126
|
+
- Browser login is interactive and should not be the default path for agents.
|
|
127
|
+
- This skill does not replace model-specific parameter validation; inspect command help before building request JSON.
|
|
128
|
+
|
|
129
|
+
## Security & Safety Notes
|
|
130
|
+
|
|
131
|
+
- Never paste API keys into example commands or PR text.
|
|
132
|
+
- Prefer `RUNAPI_API_KEY` or stdin token import instead of command-line secrets.
|
|
133
|
+
- Do not run interactive `runapi login` by default from an agent.
|
|
134
|
+
- Check the CLI exit code before assuming a task succeeded.
|
|
135
|
+
|
|
136
|
+
## References
|
|
137
|
+
|
|
138
|
+
- RunAPI CLI skill: https://github.com/runapi-ai/cli-skill
|
|
139
|
+
- RunAPI CLI repository: https://github.com/runapi-ai/cli
|
|
140
|
+
- RunAPI model catalog: https://runapi.ai/models.md
|
|
@@ -33,10 +33,11 @@ The cleanest approach is a reusable `JsonLd` component:
|
|
|
33
33
|
```jsx
|
|
34
34
|
// components/JsonLd.jsx
|
|
35
35
|
export function JsonLd({ data }) {
|
|
36
|
+
const json = JSON.stringify(data).replace(/</g, '\\u003c');
|
|
36
37
|
return (
|
|
37
38
|
<script
|
|
38
39
|
type="application/ld+json"
|
|
39
|
-
dangerouslySetInnerHTML={{ __html:
|
|
40
|
+
dangerouslySetInnerHTML={{ __html: json }}
|
|
40
41
|
/>
|
|
41
42
|
);
|
|
42
43
|
}
|
|
@@ -61,8 +61,10 @@ Show the proposed branch name and ask for one-word confirmation (or type alterna
|
|
|
61
61
|
- If not on main/master: check if current branch matches proposed name
|
|
62
62
|
- If yes: stay on it
|
|
63
63
|
- If no: ask to switch or create new
|
|
64
|
-
- Create branch
|
|
65
|
-
- Stage
|
|
64
|
+
- Create branch only after validating the branch name, then use `git checkout -b "$branch_name"`
|
|
65
|
+
- Stage explicit pathspecs only: `git add -- path/to/file ...`
|
|
66
|
+
- If file paths are generated, keep them NUL-delimited (`git diff -z --name-only`) and pass them as pathspec arguments.
|
|
67
|
+
- Never concatenate untrusted filenames into a shell command and never run the placeholder text literally.
|
|
66
68
|
- Auto-generate commit message from changes:
|
|
67
69
|
- First line: `<type>: <short description>` (max 72 chars)
|
|
68
70
|
- Body: grouped file changes with brief descriptions
|