Skip to content
Back to search

super-board

MarketplaceWorks with Claude CodeGitHub

Eric Tech's super-board pack: an autonomous GitHub Project board runner and its lane skills.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/erictechpro--super-board/badge.svg)](/listings/erictechpro--super-board)

HTML

<a href="/listings/erictechpro--super-board"><img src="/api/listings/erictechpro--super-board/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Before you start:

- [ ] Claude Code, and `gh` with board access: `gh auth refresh -s project,read:project,repo` - [ ] Dynamic workflows on in `/config` ([backends](docs/super-board/README.md#backends)) - [ ] `verify_commands` set in your config, so the merge gate can prove the build ([setup notes](docs/super-board/README.md#setup-notes))

In your project folder:

curl -fsSL https://raw.githubusercontent.com/EricTechPro/super-board/main/get.sh | bash

Or as a Claude Code plugin:

/plugin marketplace add EricTechPro/super-board
/plugin install super-board@super-board

> [!NOTE] > The plugin ships the skills only. Run `/super-board:super-board onboard` and its 🔍 Checks step adds the guard hooks, scripts and workflows. Needs Claude Code, `gh`, `jq`, bash 3.2+ and Python 3.9+; the installer checks.

Security

Two security skills come with every install, and they stay separate:

| Skill | Runs | Covers | |---|---|---| | [`pr-security-review`](skills/pr-security-review/README.md) | **On every PR**, inside the QA lane. Each finding fails QA and goes back to Build. | The PR's diff against its base: high-confidence, exploitable bugs only. From Anthropic's [claude-code-security-review](https://github.com/anthropics/claude-code-security-review). | | `security-audit` | **Only when you ask** (`/security-audit`). The board never runs it. | The whole repository, in depth. From Cloudflare's [security-audit-skill](https://github.com/cloudflare/security-audit-skill), fetched at install with `npx skills`. |

`--no-helper-skills` skips the `security-audit` download; `/super-board onboard` adds it later. Claude Code's built-in `/security-review` is left as it is.

Running from Codex or OpenCode? See [supported hosts](docs/hosts.md) for tested versions, sign-in and gaps.

Optional post-run learning can delegate an already installed `calibrate` skill after verified selected work completes. It applies only to explicitly permitted existing canonical skill files; the package bundles no private skill. See [post-run calibration](skills/super-board/references/calibration.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "super-board",
  3. "description": "Eric Tech's super-board pack: an autonomous GitHub Project board runner and its lane skills.",
  4. "owner": { "name": "Eric Tech", "url": "https://github.com/EricTechPro" },
  5. "plugins": [
  6. {
  7. "name": "super-board",
  8. "source": "./",
  9. "description": "Autonomous GitHub Project board runner: super-board, super-build, super-qa, super-review, super-collect, visual, git-sync, ui-refine-loop, pr-security-review (security pass on every PR; onboard adds Cloudflare's on-demand security-audit). After install, run /super-board onboard to add the guard hooks, .claude/bin scripts and workflows a plugin cannot ship.",
  10. "category": "development",
  11. "homepage": "https://github.com/EricTechPro/super-board"
  12. }
  13. ]
  14. }
README.md · README · 234 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="docs/assets/logo.svg" width="88" height="88" alt="super-board kanban logo">
  3. <h1>super-board</h1>
  4. <p><strong>Add tasks, walk away, get merged PRs with proof.</strong></p>
  5. <p>Stop babysitting coding agents: cards you drop in Ready come back as tested, reviewed PRs.</p>
  6. <p>9 skills (5 you type, 4 the board runs) · 9 commands · 6 guard hooks</p>
  7. <p>
  8. <img alt="Version" src="https://img.shields.io/badge/version-3.3.0-1f883d?style=flat-square">
  9. <img alt="Host" src="https://img.shields.io/badge/Claude%20Code-skills-d97757?style=flat-square">
  10. <img alt="License" src="https://img.shields.io/badge/license-MIT-0969da?style=flat-square">
  11. </p>
  12. <p><a href="https://erictechpro.github.io/super-board/"><strong>🌐 Live site: erictechpro.github.io/super-board</strong></a></p>
  13. <p>⭐ Star this repo if it helps · <a href="https://www.skool.com/erictech">Join the builders using this → weekly live calls, setup help</a> · <a href="https://youtu.be/aggJvNZxfKA">▶ Watch the walkthrough</a></p>
  14. <p><a href="#install">Install</a> · <a href="#quick-start">Quick start</a> · <a href="#how-it-works">How it works</a> · <a href="#skills">Skills</a> · <a href="#commands">Commands</a> · <a href="#guards--hooks">Guards</a></p>
  15. </div>
  16. <p align="center"><a href="https://erictechpro.github.io/super-board/skill-map/"><img src="docs/assets/skill-map.png" alt="The super-board skill map: open the interactive version" width="100%"></a></p>
  17. <p align="center"><sub>The skill map. Click it for the live version: zoom, pan, open any node.</sub></p>
  18. ## Install
  19. Before you start:
  20. - [ ] Claude Code, and `gh` with board access: `gh auth refresh -s project,read:project,repo`
  21. - [ ] Dynamic workflows on in `/config` ([backends](docs/super-board/README.md#backends))
  22. - [ ] `verify_commands` set in your config, so the merge gate can prove the build ([setup notes](docs/super-board/README.md#setup-notes))
  23. In your project folder:
  24. ```bash
  25. curl -fsSL https://raw.githubusercontent.com/EricTechPro/super-board/main/get.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 41 on GitHub
  26. ```
  27. Or as a Claude Code plugin:
  28. ```
  29. /plugin marketplace add EricTechPro/super-board
  30. /plugin install super-board@super-board
  31. ```
  32. > [!NOTE]
  33. > The plugin ships the skills only. Run `/super-board:super-board onboard` and its 🔍 Checks step adds the guard hooks, scripts and workflows. Needs Claude Code, `gh`, `jq`, bash 3.2+ and Python 3.9+; the installer checks.
  34. ### Security
  35. Two security skills come with every install, and they stay separate:
  36. | Skill | Runs | Covers |
  37. |---|---|---|
  38. | [`pr-security-review`](skills/pr-security-review/README.md) | **On every PR**, inside the QA lane. Each finding fails QA and goes back to Build. | The PR's diff against its base: high-confidence, exploitable bugs only. From Anthropic's [claude-code-security-review](https://github.com/anthropics/claude-code-security-review). |
  39. | `security-audit` | **Only when you ask** (`/security-audit`). The board never runs it. | The whole repository, in depth. From Cloudflare's [security-audit-skill](https://github.com/cloudflare/security-audit-skill), fetched at install with `npx skills`. |
  40. `--no-helper-skills` skips the `security-audit` download; `/super-board onboard` adds it later.
  41. Claude Code's built-in `/security-review` is left as it is.
  42. Running from Codex or OpenCode? See [supported hosts](docs/hosts.md) for tested versions, sign-in and gaps.
  43. Optional post-run learning can delegate an already installed `calibrate` skill after
  44. verified selected work completes. It applies only to explicitly permitted existing
  45. canonical skill files; the package bundles no private skill. See
  46. [post-run calibration](skills/super-board/references/calibration.md).
  47. ## Quick start
  48. ### 1. Install
  49. ```bash
  50. curl -fsSL https://raw.githubusercontent.com/EricTechPro/super-board/main/get.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 78 on GitHub
  51. ```
  52. ### 2. Onboard
  53. ```
  54. /super-board onboard
  55. ```
  56. Checks · GitHub · Board · Branch · AGENTS.md · Policies · Bug sources · Review. <kbd>Enter</kbd> takes the recommended answer.
  57. ### 3. Run
  58. ```
  59. /super-board run my-app
  60. ```
  61. Add cards to `Ready`. The board drains on its own.
  62. ## How it works
  63. **Which path?** Clear idea, foggy idea or bugs: [the routing rule](docs/super-board/routing.md) says what to run, and when 1–5 tickets go to `/implement-spec` instead of the board.
  64. <p align="center"><a href="https://youtu.be/aggJvNZxfKA"><img src="https://i.ytimg.com/vi/aggJvNZxfKA/maxresdefault.jpg" alt="Watch I Built a Self-Improving Software Factory by Eric Tech on YouTube" width="100%"></a></p>
  65. <p align="center"><a href="https://youtu.be/aggJvNZxfKA"><strong>▶ Watch on YouTube: I Built a Self-Improving Software Factory</strong></a></p>
  66. ## Skills
  67. **9 skills (5 you type, 4 the board runs).** Uses [Matt Pocock skills](https://github.com/mattpocock/skills), ponytail, impeccable, humanizer, [Anthropic's security review](https://github.com/anthropics/claude-code-security-review) and [Cloudflare's security-audit](https://github.com/cloudflare/security-audit-skill).
  68. <!-- skills:start -->
  69. **You type — 5 skills**
  70. | Skill | What it does |
  71. |---|---|
  72. | [`/super-board`](skills/super-board/README.md) | Orchestrator: plans waves, runs Build → QA → Review, merges when green. |
  73. | [`/super-collect`](skills/super-collect/README.md) | Finds problems, verifies them, writes a findings doc for /to-spec and /to-tickets. |
  74. | [`/ui-refine-loop`](skills/ui-refine-loop/README.md) | Critique → refine loop that polishes one page or component. |
  75. | [`/visual`](skills/visual/README.md) | One HTML page: branch recap, plan, or codebase map with diagrams. |
  76. | [`/git-sync`](skills/git-sync/README.md) | Commit per logical change, merge-pull, push without force, report. |
  77. **The board runs — 4 skills**
  78. | Skill | What it does |
  79. |---|---|
  80. | [`/super-build`](skills/super-build/README.md) | Builder lane: worktree, smallest safe change, tests, draft PR. |
  81. | [`/super-qa`](skills/super-qa/README.md) | Tester lane: evidence, test-gap check, screenshots, or bounce to Build. |
  82. | [`/super-review`](skills/super-review/README.md) | Reviewer lane: own hypotheses, remembers prior findings, merge gate. |
  83. | [`/pr-security-review`](skills/pr-security-review/README.md) | Security pass on every PR diff; super-qa runs it, findings fail QA. |
  84. <!-- skills:end -->
  85. Each name links to that skill's README. Adding a skill? Write its `SKILL.md` and `README.md`, add a line to `skills/families.json`, and this table updates itself.
  86. ## Commands
  87. ```
  88. /super-board onboard # 8-step setup, resumes
  89. /super-board lint # vague ACs?
  90. /super-board status # read-only snapshot
  91. /super-board run <slug> # drain the board
  92. /super-board stop # stop workers
  93. /super-collect [source] # find problems → findings doc → /to-spec
  94. /ui-refine-loop <route> # polish one page
  95. /visual [recap|plan|path] # one HTML page
  96. /git-sync # commit, pull, push
  97. ```
  98. Flags: `run --low|--high` · `run --codex[=<model>]` · `super-collect --since 30d`
  99. ## Guards & hooks
  100. Run automatically once installed. Python stdlib, JSON in, JSON out.
  101. | | |
  102. | --- | --- |
  103. | [guard-worktree-path](hooks/guard-worktree-path.py) | Blocks `git worktree add` outside `.claude/worktrees/` |
  104. | [guard-secrets](hooks/guard-secrets.py) | Blocks reading or piping dotenv files, SSH keys and credential files; key names via `super-board-env-check.sh` |
  105. | [guard-key-literals](hooks/guard-key-literals.py) | Blocks a live-looking API key written into a file; flags one already there |
  106. | [guard-delete-outside](hooks/guard-delete-outside.py) | Blocks `rm`, `find -delete` and `git clean` aimed outside the project, `~` or `/` |
  107. | [guard-protected-push](hooks/guard-protected-push.py) | Opt-in (`onboard` asks, or `install.sh --protect-main`): blocks direct and force pushes to main/master/base |
  108. | [README sync](scripts/super-board-readme-sync.py) | Regenerates the skill table; pre-commit and PostToolUse hooks keep it fresh |
  109. | [cleanup-wt](hooks/cleanup-wt.py) | Removes merged worktrees and branches after each merge and at session start, with a recovery file |
  110. | [merge gate](scripts/super-board-merge-gate.sh) | Merges only after the current base plus your non-empty project `verify_commands` pass (missing checks halt setup), pinned to the reviewed commit; applies `merge_policy` and runs allowed DB migrations |
  111. ## Models
  112. A cheap router grades each card easy, medium or hard first; the run flag picks the model for each grade. With `--codex`, every lane runs on Codex GPT models instead of Claude.
  113. | Command | Router | Easy card | Medium card | Hard card |
  114. | --- | --- | --- | --- | --- |
  115. | `/super-board run` | Haiku 4.5 | Sonnet 5.5 | Opus 5.5 | session model |
  116. | `/super-board run --low` | Haiku 4.5 | Haiku 4.5 | Sonnet 5.5 | Opus 5.5 |
  117. | `/super-board run --high` | Sonnet 5.5 | Opus 5.5 | Opus 5.5 | Opus 5.5 |
  118. | `/super-board run --codex` | gpt-6-luna | gpt-6.1-sol | gpt-6.1-sol | gpt-6-astra |
  119. | `/super-board run --codex --low` | gpt-6-luna | gpt-6-luna | gpt-6.1-sol | gpt-6.1-sol |
  120. | `/super-board run --codex --high` | gpt-6-luna | gpt-6-astra | gpt-6-astra | gpt-6-astra |
  121. `/super-board run --codex=<model>` pins one model for every card and skips the router.
  122. Run inside Codex? plain `/super-board run` switches to the Codex ladder by itself. Codex has no
  123. `/super-board` command: it finds skills in `.agents/skills/` (symlinks followed), so link
  124. `.claude/skills/super-board` there and type `$super-board run`.
  125. ## Writing standard
  126. Commits, tickets, PR bodies and comments all follow [one writing standard](https://erictechpro.github.io/super-board/writing-standard/), in the pack and in every project it is installed into.
  127. <details>
  128. <summary><strong>Upgrading from 2.x</strong></summary>
  129. 1. Re-run the install line.
  130. 2. Run `/super-board onboard`; step 1 upgrades for you and keeps a backup.
  131. 3. Try `board-migrate --dry-run` on a copy of your board first.
  132. [Full notes](RELEASE-NOTES.md#upgrading-from-2x)
  133. </details>
  134. ## Credits
  135. MIT © Eric Tech ([LICENSE](LICENSE)). Built on [obra/superpowers](https://github.com/obra/superpowers), [mattpocock/skills](https://github.com/mattpocock/skills), [BuilderIO/skills](https://github.com/BuilderIO/skills) and [tt-a1i/archify](https://github.com/tt-a1i/archify). `pr-security-review` is ported from [anthropics/claude-code-security-review](https://github.com/anthropics/claude-code-security-review) (MIT © 2025 Anthropic, [notice](skills/pr-security-review/LICENSE)); `security-audit` is [cloudflare/security-audit-skill](https://github.com/cloudflare/security-audit-skill) (MIT © 2025-2026 Cloudflare, Inc.), installed from its own repo, not bundled.
  136. ---
  137. <p align="center">
  138. <a href="https://erictechpro.github.io/super-board/">Live site</a> ·
  139. <a href="https://erictechpro.github.io/super-board/skill-map/">Skill map</a> ·
  140. <a href="https://erictechpro.github.io/super-board/writing-standard/">Writing standard</a> ·
  141. <a href="https://erictechpro.github.io/super-board/onboarding/">Setup simulator</a> ·
  142. <a href="https://erictechpro.github.io/super-board/impeccable/">Impeccable map</a> ·
  143. <a href="https://erictechpro.github.io/super-board/pstack/">pstack map</a> ·
  144. <a href="https://erictechpro.github.io/super-board/security-audit/">Security audit map</a> ·
  145. <a href="RELEASE-NOTES.md">Release notes</a> ·
  146. <a href="RELEASING.md">Release checks</a> ·
  147. <a href="https://youtu.be/nX_bGyIOFM4">YouTube walkthrough</a>
  148. </p>
  149. <p align="center"><sub>Made by Eric Tech</sub></p>
  150. ### Worker skill availability
  151. Setup and dispatch resolve real, nonempty `SKILL.md` files for the actual
  152. Claude or Codex host. Missing required skills halt before claims or workers;
  153. lockfiles and arbitrary plugin caches do not count. The shared registry in
  154. `scripts/super-board-skills-ready.py` owns lane dependencies, overrides and the
  155. two declared ponytail fallbacks. The QA lane requires the bundled
  156. `pr-security-review`; Cloudflare's `security-audit` is an optional QA entry,
  157. so a missing copy never halts a run. Setup's full helper union may be red while a
  158. selected card is runnable. Read-only checks never install; explicit onboard
  159. repair rechecks files after installation.
  160. The CLI accepts `--home <fixture-home>` and `--catalog <active-skills.json>`.
  161. Launchers accept the same inventory through `SUPER_BOARD_SKILLS_HOME` and
  162. `SUPER_BOARD_SKILLS_CATALOG`; neither changes the actual host. Catalog shape:
  163. `{"host":"codex","skills":[{"name":"vendor:skill","path":"/exact/SKILL.md",
  164. "enabled":true,"scope":"project","project_root":"/exact/project"}]}`.
  165. User entries use `scope:"user"`. Restart explicitly after repairing missing
  166. skills; readiness certifies availability, not their content or external tools.
get.sh · Bundled script · 205 lines · 2 findings marked
  1. #!/usr/bin/env bash
  2. # super-board one-line installer.
  3. #
  4. # curl -fsSL https://raw.githubusercontent.com/EricTechPro/super-board/main/get.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 4 on GitHub
  5. # curl -fsSL https://raw.githubusercontent.com/EricTechPro/super-board/main/get.sh | bash -s -- --protect-main
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 5 on GitHub
  6. #
  7. # Options (everything else that starts with "-" goes straight to install.sh):
  8. # --target <dir> project to install into (default: the current folder)
  9. # --ref <tag|branch> which version to fetch (default: the latest release)
  10. # --no-helper-skills skip `npx skills@latest add` for mattpocock/skills and
  11. # cloudflare/security-audit-skill
  12. # -h, --help show this help
  13. # Passed through to install.sh: --no-hooks, --protect-main, --hosts=<list>.
  14. #
  15. # Environment:
  16. # SUPER_BOARD_REF same as --ref
  17. # SUPER_BOARD_REPO GitHub owner/repo to fetch from (default EricTechPro/super-board)
  18. # SUPER_BOARD_TARBALL exact tarball URL to fetch instead (file:// works; used by tests)
  19. #
  20. # Written for bash 3.2 (stock macOS). The whole script lives in main(), called on
  21. # the last line, so a download cut off halfway through runs nothing.
  22. set -euo pipefail
  23. say() { printf '%s\n' "$*"; }
  24. warn() { printf '⚠️ %s\n' "$*" >&2; }
  25. die() { printf '❌ %s\n' "$*" >&2; exit "${2:-1}"; }
  26. have() { command -v "$1" >/dev/null 2>&1; }
  27. usage() { sed -n '2,20p' "${BASH_SOURCE[0]:-$0}" 2>/dev/null | sed 's/^# \{0,1\}//' || true; }
  28. # Matt Pocock's skills count as present when the project's skills-lock.json
  29. # lists them, or two of their skills already sit in a skills folder Claude reads.
  30. helper_skills_present() {
  31. local t="$1" d
  32. if [ -f "$t/skills-lock.json" ] && grep -q 'mattpocock/skills' "$t/skills-lock.json" 2>/dev/null; then
  33. return 0
  34. fi
  35. for d in "$t/.claude/skills" "${HOME:-/nonexistent}/.claude/skills"; do
  36. if [ -f "$d/grilling/SKILL.md" ] && [ -f "$d/tdd/SKILL.md" ]; then return 0; fi
  37. done
  38. return 1
  39. }
  40. # Cloudflare's security-audit counts as present when skills-lock.json lists it, or its
  41. # SKILL.md already sits in a skills folder Claude reads.
  42. security_audit_present() {
  43. local t="$1" d
  44. if [ -f "$t/skills-lock.json" ] && grep -q 'cloudflare/security-audit-skill' "$t/skills-lock.json" 2>/dev/null; then
  45. return 0
  46. fi
  47. for d in "$t/.claude/skills" "$t/.agents/skills" "${HOME:-/nonexistent}/.claude/skills"; do
  48. [ ! -f "$d/security-audit/SKILL.md" ] || return 0
  49. done
  50. return 1
  51. }
  52. main() {
  53. local target="" ref="${SUPER_BOARD_REF:-}" helpers=1
  54. local repo="${SUPER_BOARD_REPO:-EricTechPro/super-board}"
  55. local pass=()
  56. while [ $# -gt 0 ]; do
  57. case "$1" in
  58. --target) [ $# -ge 2 ] || die "--target needs a folder" 64; target="$2"; shift 2 ;;
  59. --target=*) target="${1#--target=}"; shift ;;
  60. --ref) [ $# -ge 2 ] || die "--ref needs a tag or branch name" 64; ref="$2"; shift 2 ;;
  61. --ref=*) ref="${1#--ref=}"; shift ;;
  62. --no-helper-skills) helpers=0; shift ;;
  63. -h|--help) usage; exit 0 ;;
  64. -*) pass+=("$1"); shift ;;
  65. *) [ -z "$target" ] || die "two target folders given: '$target' and '$1'" 64; target="$1"; shift ;;
  66. esac
  67. done
  68. target="${target:-$PWD}"
  69. # --- safety -----------------------------------------------------------
  70. if [ "$(id -u)" -eq 0 ]; then
  71. die "please don't run this as root (or with sudo). Run it as your normal user, inside your project folder." 1
  72. fi
  73. [ -d "$target" ] || die "the target '$target' is not a folder. Create it first, or pass --target <an existing folder>." 64
  74. target="$(cd "$target" && pwd)"
  75. say "🧩 super-board installer"
  76. say " target: $target"
  77. # --- prerequisites ----------------------------------------------------
  78. local fetch=""
  79. if have curl && have tar; then fetch="tar"
  80. elif have git; then fetch="git"
  81. else die "I need either curl + tar, or git, to download super-board. Install one of those and run this again." 69
  82. fi
  83. have python3 || die "python3 is missing. super-board's installer and scripts use it. Install Python 3 (https://www.python.org/downloads/) and run this again." 69
  84. # One grouped line: what is here ✓, what is not ✗ (onboard's 🔍 Checks installs it).
  85. local later="" ok="" t
  86. for t in curl tar git python3 gh jq node; do
  87. case "$t" in
  88. curl|tar) [ "$fetch" = "tar" ] || continue ;;
  89. git) [ "$fetch" = "git" ] || continue ;;
  90. esac
  91. if have "$t" && { [ "$t" != node ] || have npx; }; then ok="${ok:+$ok · }$t"; else later="$later $t"; fi
  92. done
  93. say "🔍 checking what you need"
  94. if [ -n "$later" ]; then
  95. say " ✓ $ok ✗$later (🔍 Checks in onboard installs them)"
  96. else
  97. say " ✓ $ok"
  98. fi
  99. case " $later " in *" node "*) helpers=0 ;; esac
  100. # --- download ---------------------------------------------------------
  101. local tmp
  102. tmp="$(mktemp -d 2>/dev/null || mktemp -d -t super-board)"
  103. # shellcheck disable=SC2064
  104. trap "rm -rf '$tmp'" EXIT INT TERM
  105. local url="${SUPER_BOARD_TARBALL:-}" label
  106. if [ -n "$url" ]; then
  107. fetch="tar"; label="$url"
  108. elif [ "$fetch" = "tar" ]; then
  109. if [ -z "$ref" ]; then
  110. ref="$(curl -fsSL "https://api.github.com/repos/$repo/releases/latest" 2>/dev/null \
  111. | python3 -c 'import json,sys
  112. try: print(json.load(sys.stdin).get("tag_name",""))
  113. except Exception: print("")' 2>/dev/null || true)"
  114. if [ -z "$ref" ]; then warn "couldn't find a published release; using the main branch instead."; ref="main"; fi
  115. fi
  116. url="https://codeload.github.com/$repo/tar.gz/$ref"
  117. label="$repo@$ref"
  118. else
  119. label="$repo@${ref:-default branch}"
  120. fi
  121. say "📦 downloading $label"
  122. local src=""
  123. if [ "$fetch" = "tar" ]; then
  124. curl -fsSL "$url" -o "$tmp/pack.tgz" || die "download failed: $url. Check the version name and your internet connection." 1
  125. mkdir -p "$tmp/x"
  126. tar -xzf "$tmp/pack.tgz" -C "$tmp/x" || die "the download isn't a valid tarball: $url" 1
  127. if [ -f "$tmp/x/install.sh" ]; then src="$tmp/x"
  128. else
  129. local d
  130. for d in "$tmp"/x/*/; do
  131. if [ -f "${d}install.sh" ]; then src="${d%/}"; break; fi
  132. done
  133. fi
  134. else
  135. if [ -n "$ref" ]; then
  136. git clone -q --depth 1 --branch "$ref" "https://github.com/$repo.git" "$tmp/x" || die "git clone of $label failed." 1
  137. else
  138. git clone -q --depth 1 "https://github.com/$repo.git" "$tmp/x" || die "git clone of $label failed." 1
  139. fi
  140. src="$tmp/x"
  141. fi
  142. [ -n "$src" ] && [ -f "$src/install.sh" ] || die "the download has no install.sh at its top level — is '$label' really super-board?" 1
  143. local version="?"
  144. [ -f "$src/VERSION" ] && version="$(tr -d '[:space:]' < "$src/VERSION")"
  145. # --- install ----------------------------------------------------------
  146. # Quiet mode: install.sh prints only its "🔧 installing" group; the summary is ours.
  147. SUPER_BOARD_QUIET_NEXT=1 bash "$src/install.sh" ${pass[@]+"${pass[@]}"} "$target" || die "install.sh stopped with an error (see above). Nothing else was changed after that point." 1
  148. # --- helper skills ----------------------------------------------------
  149. local helper_note
  150. if [ "$helpers" -eq 0 ]; then
  151. case " $later " in
  152. *" node "*) helper_note="skipped — 🔍 Checks will fix this" ;;
  153. *) helper_note="skipped (--no-helper-skills)" ;;
  154. esac
  155. elif helper_skills_present "$target"; then
  156. helper_note="already installed"
  157. else
  158. # stdin is this script when piped into bash, so give npx nothing to read. npx's
  159. # own chatter goes to a log so the summary stays grouped.
  160. if (cd "$target" && npx -y skills@latest add mattpocock/skills --skill '*' -a claude-code -y </dev/null >"$tmp/npx.log" 2>&1); then
  161. helper_note="installed"
  162. else
  163. helper_note="failed — 🔍 Checks retries it (or: npx skills@latest add mattpocock/skills)"
  164. fi
  165. fi
  166. # --- security-audit (Cloudflare, standalone, run on demand) ------------
  167. local audit_note
  168. if [ "$helpers" -eq 0 ]; then
  169. case " $later " in
  170. *" node "*) audit_note="skipped — 🔍 Checks will fix this" ;;
  171. *) audit_note="skipped (--no-helper-skills)" ;;
  172. esac
  173. elif security_audit_present "$target"; then
  174. audit_note="already installed"
  175. elif (cd "$target" && npx -y skills@latest add cloudflare/security-audit-skill --skill security-audit -a claude-code -y </dev/null >"$tmp/npx-audit.log" 2>&1); then
  176. audit_note="installed"
  177. else
  178. audit_note="failed — 🔍 Checks retries it (or: npx skills@latest add cloudflare/security-audit-skill --skill security-audit)"
  179. fi
  180. # --- summary ----------------------------------------------------------
  181. say "🧠 helper skills: $helper_note"
  182. say "🔒 security-audit: $audit_note"
  183. say "🎉 super-board $version is installed"
  184. say "👉 next: open Claude Code here and run /super-board onboard"
  185. }
  186. main "$@"

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.