Skip to content

armgit / brag

Public Imported from GitHub
0

You built it. Now brag. Turn the project you just created into a short, shareable launch video with one command.

Add per-agent symlinks for auto-discovery, drop adapters/

anukulKunb03fb80d6afd
diff --git a/.agents/skills/brag b/.agents/skills/brag
new file mode 120000
index 0000000..cacc2b2
--- /dev/null
+++ b/.agents/skills/brag
@@ -0,0 +1 @@
+../../skills/brag
diff --git a/.claude/skills/brag b/.claude/skills/brag
new file mode 120000
index 0000000..cacc2b2
--- /dev/null
+++ b/.claude/skills/brag
@@ -0,0 +1 @@
+../../skills/brag
diff --git a/.opencode/skills/brag b/.opencode/skills/brag
new file mode 120000
index 0000000..cacc2b2
--- /dev/null
+++ b/.opencode/skills/brag
@@ -0,0 +1 @@
+../../skills/brag
diff --git a/README.md b/README.md
index 56ce553..8d76713 100644
--- a/README.md
+++ b/README.md
@@ -29,14 +29,20 @@ Restart Claude Code after copying.
### Also works with
-| Agent | How |
+This repo exposes the skill at every agent's standard discovery path via symlinks. No extra config needed.
+
+| Agent | How it discovers |
|---|---|
-| **opencode** | `git clone ... ~/.config/opencode/skills/brag/` or point `opencode.json` at [`adapters/opencode/`](adapters/opencode/) |
-| **Codex, Cursor, Aider, etc.** | Load [`AGENT.md`](AGENT.md) into custom instructions; see [`adapters/generic/`](adapters/generic/) |
+| **opencode** | Auto-detects from `.opencode/skills/brag/` at project root |
+| **Codex CLI** | Reads `.agents/skills/brag/`, walking up to repo root |
+| **Claude Code** | Also reads `.claude/skills/brag/` (in addition to the `.claude-plugin/` marketplace install above) |
+| **Other agents** | Point custom instructions at `skills/brag/SKILL.md` — see [`docs/other-agents.md`](docs/other-agents.md) |
+
+> **Windows users:** Git requires `git config core.symlinks true` (or `git clone -c core.symlinks=true`) and Windows Developer Mode or Administrator privileges to create symlinks. If symlinks don't work on your system, copy `skills/brag/` to the agent's skill directory manually instead.
## Use it
-From any project directory, ask Claude:
+From any project directory, ask your agent:
```text
let's /brag
@@ -56,7 +62,7 @@ You get a `brag-output/` folder with the plan, a composition brief, share copy,
## Requirements
-- Claude Code (with skill/plugin support)
+- An agent that supports Agent Skills — Claude Code, opencode, Codex CLI, or any agent with custom instructions (see "Also works with" above)
- Node.js 22+
- FFmpeg on `PATH`
- Hyperframes CLI — `npx hyperframes` (check it with `npx hyperframes doctor`)
@@ -67,7 +73,9 @@ You get a `brag-output/` folder with the plan, a composition brief, share copy,
- `examples/` — fake product sites used as a benchmark suite
- `docs/` — the launch site (GitHub Pages)
- `.claude-plugin/` — plugin manifest + marketplace catalog
-- `adapters/` — config for opencode, Codex, and other agents
+- `.claude/skills/brag/` — symlink → `skills/brag/` (Claude Code discovery)
+- `.agents/skills/brag/` — symlink → `skills/brag/` (Codex CLI + opencode discovery)
+- `.opencode/skills/brag/` — symlink → `skills/brag/` (opencode discovery)
## Credits
diff --git a/adapters/generic/README.md b/adapters/generic/README.md
deleted file mode 100644
index 2645b64..0000000
--- a/adapters/generic/README.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# Using /brag with any AI coding agent
-
-The core skill logic lives in a single file: [`AGENT.md`](../../AGENT.md). It is plain markdown with zero plugin-specific assumptions — any AI coding agent can follow it.
-
-## How to load it
-
-### Copy-paste into custom instructions
-
-Open your agent's custom instructions or system prompt settings and paste the contents of `AGENT.md`.
-
-### Reference as a file
-
-If your agent supports loading instructions from a file:
-
-```
-path/to/AGENT.md
-```
-
-### Claude Code
-
-See [`adapters/claude-code/`](../claude-code/) for the `.claude-plugin` manifest. Install via:
-
-```bash
-rsync -a --exclude '.DS_Store' skills/brag/ ~/.claude/skills/brag/
-cp adapters/claude-code/.claude-plugin/* ~/.claude/plugins/brag/
-```
-
-### opencode
-
-See [`adapters/opencode/`](../opencode/) for the `opencode.json` config. Point your `opencode.json` at this repo's `skills/` directory, or copy the skill folder into `.opencode/skills/`.
-
-### Cursor, Codex, Aider, etc.
-
-1. Read `AGENT.md` and follow the steps.
-2. Ensure the project has access to the `/brag` skill assets: clone or symlink this repo, or copy `skills/brag/` into your working directory.
-3. Run `npx hyperframes doctor` to verify Hyperframes is available.
-4. Invoke by saying `/brag` or "make a launch video".
diff --git a/adapters/opencode/opencode.json b/adapters/opencode/opencode.json
deleted file mode 100644
index b43892f..0000000
--- a/adapters/opencode/opencode.json
+++ /dev/null
@@ -1,6 +0,0 @@
-{
- "$schema": "https://opencode.ai/config.json",
- "skills": {
- "paths": ["."]
- }
-}
diff --git a/docs/other-agents.md b/docs/other-agents.md
new file mode 100644
index 0000000..be9f034
--- /dev/null
+++ b/docs/other-agents.md
@@ -0,0 +1,31 @@
+# Using /brag with other AI coding agents
+
+Agents like **Cursor**, **Aider**, or any LLM with custom instructions don't have native `SKILL.md` discovery. Use one of these methods:
+
+## Option 1: Paste into custom instructions
+
+Open your agent's custom instructions or system prompt settings and paste the full contents of [`skills/brag/SKILL.md`](../skills/brag/SKILL.md).
+
+## Option 2: Reference as a file path
+
+If your agent supports loading instructions from a file, point it at:
+
+```
+path/to/skills/brag/SKILL.md
+```
+
+## Option 3: Copy the skill folder
+
+Copy `skills/brag/` into wherever your agent looks for skill files:
+
+```bash
+cp -r skills/brag/ ~/.your-agent/skills/brag/
+```
+
+## Prerequisites
+
+Regardless of method, the environment needs:
+- **Node.js 22+**
+- **FFmpeg** on `PATH`
+- **Hyperframes CLI** — `npx hyperframes doctor` to verify
+- **This repo cloned** (or `skills/brag/` accessible) for assets (music, SFX, reference docs)