diff --git a/agent-install.md b/agent-install.md index e21dfed..ab04911 100644 --- a/agent-install.md +++ b/agent-install.md @@ -8,10 +8,16 @@ Use the selective npm installer for Codex, OpenCode, or Pi when the user wants o Use Claude Code's native plugin commands for the complete namespaced catalog. Do not assume that Claude Code loads the portable `.agents/skills` path. +## Current source and OpenCode 2.0 + +The current main branch includes 55 skills, OpenCode 2.0 support, and humanizer. The published npm package and tag v0.5.0 still contain 54 skills and the V1-only plugin. Use the Git installation for the full OpenCode 2 plugin and humanizer. + +The project-local procedure below uses the published npm catalog. Read its output before choosing skills. Do not try to install humanizer from npm 0.5.0 or change sources without the user's selection. + ## Safe project-local procedure 1. Confirm the current directory belongs to the intended Git repository. -2. Run `node --version`. Stop if Node.js is older than 20. +2. Run `node --version`. Stop if Node.js is older than 20.11.0.11.0. 3. Preview the resolved selection and destination. 4. Report the destination, selected skills, automatic companions, existing conflicts, and planned writes. 5. If the preview matches the user's requested scope, repeat the command without `--dry-run`. @@ -56,8 +62,9 @@ Verify through `/plugin`, then invoke a workflow with its collision-safe namespa ## Host verification -- Codex: start a new session, inspect `/plugins`, and invoke `$code-review` or another installed ID. -- OpenCode: start a new session, run `opencode debug skill`, and invoke `/code-review` or another installed ID. +- Codex: start a new session and invoke `$code-review` or another installed ID. Inspect `/plugins` only for a native plugin installation. +- OpenCode 1: start a new session, run `opencode debug skill`, and invoke `/code-review` or another installed ID. +- OpenCode 2: start a new session, check the skill picker, and invoke `/code-review` or another installed ID. Use `opencode debug agents` only to inspect specialists from the native plugin. - Pi: start a new session, run `pi list`, and ask for a task matching the installed workflow. - Claude Code: inspect `/plugin` and use `/opencode-power-pack:`. @@ -68,6 +75,8 @@ Help me choose and install the right OpenCode Power Pack skills safely and proje Your goal is to understand what I need, recommend the smallest useful profile or set of individual skills, obtain my explicit selection, install it for the active coding-agent host, preserve all existing project work, and leave a reproducible verification report. +The npm procedure below uses the published catalog. OpenCode 2 can use those copied skills, but the native V2 plugin and humanizer require Git main. If I need either, show the current Git install guide and wait for my source choice before continuing. + Safety rules: 1. Do not modify package.json, package-lock.json, npm-shrinkwrap.json, pnpm-lock.yaml, yarn.lock, bun.lock, or application dependencies. 2. Do not use --force, --global, --all, sudo, destructive Git commands, or manual deletion/replacement of existing skill directories. Do not choose a profile or skill for me, and do not install anything before I explicitly approve the selection. @@ -88,7 +97,7 @@ Phase 2: preflight without changing repository files. 1. Print the current directory with pwd. 2. Run git rev-parse --show-toplevel. Stop if this is not a Git repository. Save the absolute Git root. -3. Run node --version. Parse the major version and require Node.js 20 or newer. If it is older or unavailable, stop and explain how to satisfy the prerequisite without changing this project. +3. Run node --version. Parse the full version and require Node.js 20.11.0 or newer. If it is older or unavailable, stop and explain how to satisfy the prerequisite without changing this project. 4. Run npm --version and stop if npm or npx is unavailable. 5. Capture git status --short before installation. Use it only as a baseline; do not alter any listed file. 6. State that the only permitted destination is /.agents/skills. @@ -130,8 +139,9 @@ Phase 6: verify and report. 3. Run git status --short again and compare it with the saved baseline. Confirm that installation introduced no changes outside .agents/skills and did not change dependency manifests or lockfiles. Do not revert unrelated differences. 4. Tell the user to start a new agent session if the skills do not appear automatically. 5. Give the host-specific verification command: - - Codex: inspect /plugins, then invoke an installed skill such as $code-review. - - OpenCode: run opencode debug skill, then invoke /code-review. + - Codex: invoke an installed skill such as $code-review in a new session. Use /plugins only for a native plugin installation. + - OpenCode 1: run opencode debug skill, then invoke /code-review. + - OpenCode 2: check the skill picker, then invoke /code-review. - Pi: run pi list, then request a task that matches an installed workflow. 6. Finish with a concise structured report containing: stated need, approved selection and rationale, alternatives not chosen, host, Node/npm versions, Git root, destination, exact commands run, resolved skill count and names, installed entries, preserved/skipped entries, warnings or failures, worktree comparison, verification result, and any user action still required. ``` diff --git a/assets/social-card.png b/assets/social-card.png index 06a9704..75898e2 100644 Binary files a/assets/social-card.png and b/assets/social-card.png differ diff --git a/assets/social-card.svg b/assets/social-card.svg index 91be137..045d48a 100644 --- a/assets/social-card.svg +++ b/assets/social-card.svg @@ -12,11 +12,11 @@ - OPEN SOURCE // v0.5.0 + OPEN SOURCE // MAIN OPENCODE POWER PACK - 54 SKILLS · FOUR CODING AGENTS - CLAUDE CODE + CODEX + OPENCODE + PI + 55 SKILLS · FOUR CODING AGENTS + CLAUDE CODE + CODEX + OPENCODE 1 + 2 + PI diff --git a/docs/index.html b/docs/index.html index 1f839fe..feee3fc 100644 --- a/docs/index.html +++ b/docs/index.html @@ -21,7 +21,7 @@ - + @@ -45,51 +45,58 @@ href="https://fonts.googleapis.com/css2?family=Barlow+Condensed:wght@600;700;800&family=IBM+Plex+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" > - +
@@ -101,6 +108,7 @@ POWER PACK DOCS
-

Compare all 54 skills and copy individual commands →

+

Compare all 55 skills and copy individual commands →

  • Choose the destination

    @@ -231,6 +247,15 @@ npx @waybarrios/opencode-power-pack install --profile security

    +
    +

    GitHub Packages mirror

    +

    npmjs is the public install source and does not require GitHub authentication. The released package is also available through GitHub Packages.

    +

    For the mirror, use a GitHub personal access token (classic) with read:packages:

    +
    npm login --scope=@waybarrios --auth-type=legacy --registry=https://npm.pkg.github.com +npm install --global @waybarrios/opencode-power-pack --registry=https://npm.pkg.github.com
    +

    The mirror follows release tags. It does not include additions that are only on main.

    +
    +

    Let your agent install it

    @@ -246,6 +271,8 @@ npx @waybarrios/opencode-power-pack install --profile security Your goal is to understand what I need, recommend the smallest useful profile or set of individual skills, obtain my explicit selection, install it for the active coding-agent host, preserve all existing project work, and leave a reproducible verification report. +The npm procedure below uses the published catalog. OpenCode 2 can use those copied skills, but the native V2 plugin and humanizer require Git main. If I need either, show the current Git install guide and wait for my source choice before continuing. + Safety rules: 1. Do not modify package.json, package-lock.json, npm-shrinkwrap.json, pnpm-lock.yaml, yarn.lock, bun.lock, or application dependencies. 2. Do not use --force, --global, --all, sudo, destructive Git commands, or manual deletion/replacement of existing skill directories. Do not choose a profile or skill for me, and do not install anything before I explicitly approve the selection. @@ -266,7 +293,7 @@ Phase 2: preflight without changing repository files. 1. Print the current directory with pwd. 2. Run git rev-parse --show-toplevel. Stop if this is not a Git repository. Save the absolute Git root. -3. Run node --version. Parse the major version and require Node.js 20 or newer. If it is older or unavailable, stop and explain how to satisfy the prerequisite without changing this project. +3. Run node --version. Parse the full version and require Node.js 20.11.0 or newer. If it is older or unavailable, stop and explain how to satisfy the prerequisite without changing this project. 4. Run npm --version and stop if npm or npx is unavailable. 5. Capture git status --short before installation. Use it only as a baseline; do not alter any listed file. 6. State that the only permitted destination is <git-root>/.agents/skills. @@ -308,8 +335,9 @@ Phase 6: verify and report. 3. Run git status --short again and compare it with the saved baseline. Confirm that installation introduced no changes outside .agents/skills and did not change dependency manifests or lockfiles. Do not revert unrelated differences. 4. Tell the user to start a new agent session if the skills do not appear automatically. 5. Give the host-specific verification command: - - Codex: inspect /plugins, then invoke an installed skill such as $code-review. - - OpenCode: run opencode debug skill, then invoke /code-review. + - Codex: invoke an installed skill such as $code-review in a new session. Use /plugins only for a native plugin installation. + - OpenCode 1: run opencode debug skill, then invoke /code-review. + - OpenCode 2: check the skill picker, then invoke /code-review. - Pi: run pi list, then request a task that matches an installed workflow. 6. Finish with a concise structured report containing: stated need, approved selection and rationale, alternatives not chosen, host, Node/npm versions, Git root, destination, exact commands run, resolved skill count and names, installed entries, preserved/skipped entries, warnings or failures, worktree comparison, verification result, and any user action still required.

    @@ -736,19 +770,27 @@ npm uninstall --global @waybarrios/opencode-power-pack codex plugin add opencode-power-pack@opencode-power-pack codex plugin remove opencode-power-pack@opencode-power-pack -

    OpenCode

    -
    opencode plugin --global --force "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git"
    -

    To remove it, delete the matching opencode-power-pack@... entry from the config where it was installed, then restart OpenCode.

    +

    OpenCode 2

    +
    opencode plugin update "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git" +opencode plugin remove "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git"
    +

    Use the exact configured specification, including a tag or local Git URL. On OpenCode 1, update by reinstalling with plugin --global; remove its entry from the plugin config array to uninstall. For local clones, pull the source and then update or reinstall.

    Pi

    pi update git:github.com/waybarrios/opencode-power-pack pi remove git:github.com/waybarrios/opencode-power-pack
    +
    +

    Contributor checks and live evaluations

    +

    The behavioral runner uses the OpenCode 2 session API. It rejects partial text from failed or interrupted turns and accepts optional provider/model#variant model references.

    +

    Live runs need provider environment credentials. The isolated runtime does not copy OpenCode 2's credential database. See the evaluation guide for setup and evidence review.

    +

    The OpenCode compatibility guide covers version checks, source selection, updates, and specialist permissions.

    +
    +

    Troubleshooting

    Node rejects the package

    -

    The selective installer requires Node.js 20 or newer. Check with node --version, upgrade Node, and run the same npx command again.

    +

    The selective installer requires Node.js 20.11.0 or newer. Check with node --version, upgrade Node, and run the same npx command again.

    Unknown skill or profile

    Run npx @waybarrios/opencode-power-pack list and copy the lowercase hyphenated ID exactly. Profile names and skill IDs are case-sensitive.

    @@ -787,6 +829,6 @@ pi remove git:github.com/waybarrios/opencode-power-pack
    - + diff --git a/docs/index.md b/docs/index.md index 65c6fce..f90fcfa 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,10 +1,16 @@ # OpenCode Power Pack Installation and Operations -This guide covers selective npm installation, native host installation, and contained command execution for OpenCode Power Pack v0.5.0. +This guide covers selective npm installation, native host installation, and contained command execution for the current main branch and the published npm release. + +## What is available now + +The current main branch includes 55 skills, OpenCode 2.0 support, and humanizer. The published npm package and tag v0.5.0 still contain 54 skills and the V1-only plugin. Use the Git installation for the full OpenCode 2 plugin and humanizer. + +The npm installer still works for its released skills on OpenCode 2. Copying skills does not register the plugin's three named specialists. ## Choose an installation path -Use the selective npm installer when Codex, OpenCode, or Pi should load only chosen skills or a curated profile. It requires Node.js 20 or newer and installs into a portable `.agents/skills` directory. +Use the selective npm installer when Codex, OpenCode, or Pi should load only chosen skills or a curated profile. It requires Node.js 20.11.0 or newer and installs into a portable `.agents/skills` directory. Use the host-native plugin or package installation when you want the full catalog and native activation behavior. Claude Code, Codex, OpenCode, and Pi each use their own host mechanism. @@ -25,12 +31,25 @@ npx @waybarrios/opencode-power-pack install code-review --project npx @waybarrios/opencode-power-pack install --profile review --dry-run npx @waybarrios/opencode-power-pack install --profile review -# Install all 54 skills +# Install every skill in the published npm catalog npx @waybarrios/opencode-power-pack install --all ``` The installer resolves required companion skills. Existing skills are not overwritten unless `--force` is supplied. Use `--dry-run` before any forced update. +## GitHub Packages mirror + +npmjs is the public install source and does not require GitHub authentication. The same released package is also available through GitHub Packages. + +Use a GitHub personal access token (classic) with `read:packages` for the mirror: + +```sh +npm login --scope=@waybarrios --auth-type=legacy --registry=https://npm.pkg.github.com +npm install --global @waybarrios/opencode-power-pack --registry=https://npm.pkg.github.com +``` + +The mirror follows release tags. It does not include additions that are only on main. + ## Agent-assisted installation A terminal-capable Codex, OpenCode, or Pi agent can install the recommended profile at project scope with a dry-run-first sequence: @@ -63,13 +82,23 @@ codex plugin list --marketplace opencode-power-pack Start a new Codex session and invoke a skill such as `$code-review`. -### OpenCode +### OpenCode 1 and 2 + +Use Git main for OpenCode 2.0 support and the 55-skill catalog. The v0.5.0 tag contains the earlier V1-only plugin. ```sh -opencode plugin --global "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git#v0.5.0" +# OpenCode 2 +opencode plugin add "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git" + +# OpenCode 1 +opencode plugin --global "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git" ``` -Start a new OpenCode session and invoke a skill such as `/code-review`. +Restart OpenCode and invoke a skill such as `/code-review` or `/humanizer`. On V2, run `opencode debug agents` to inspect the three specialists. On V1, use `opencode debug skill` and `opencode debug agent code-explorer`. + +V2 enforces the bundled specialists' read-only restrictions when it evaluates permissions, even with global allow rules. A custom system prompt or primary mode replaces the bundled role and keeps host permission defaults. The debug listing can still show the host's base permissions. + +Smoke tests cover OpenCode 1.18.7, 2.0.14, and 2.0.32. They verify all 55 skills and three specialists without model calls. ### Pi @@ -185,9 +214,20 @@ macOS and Linux are supported. WSL2 is expected through the Linux backend but st - `frontend`: frontend implementation plus anti-generic design critique. - `security`: AppSec review, scanning, modeling, validation, and reporting. - `huggingface`: model discovery, inference, training, evaluation, Spaces, and AWS deployment. -- `authoring`: skills, MCP servers, and technical-paper summaries. +- `authoring`: humanizer, skill-creator, mcp-builder, and paper-summarizer on main. npm 0.5.0 has the three earlier authoring skills. - `project-memory`: durable AGENTS.md and CLAUDE.md maintenance. +## Humanizer from current source + +Run the selective installer from Git main for a user-level copy: + +```sh +npx --package=git+https://github.com/waybarrios/opencode-power-pack.git opencode-power-pack install humanizer --dry-run +npx --package=git+https://github.com/waybarrios/opencode-power-pack.git opencode-power-pack install humanizer +``` + +Use `install --profile authoring` instead for all four authoring skills. For project scope, run the same command from the target repository with `--project`. + ## Update and remove Preview an npm-managed skill update, then apply it only if the destination is correct: @@ -199,6 +239,19 @@ npx @waybarrios/opencode-power-pack install code-review --force For host-native installations, use that host's plugin or package update and removal commands. Avoid activating the same workflow from both a native plugin and an npm copy at the same scope. +On OpenCode 2, update or remove with the exact configured package specification: + +```sh +opencode plugin update "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git" +opencode plugin remove "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git" +``` + +On V1, reinstall with `plugin --global` to update, or remove its entry from the `plugin` config array. For a local `git+file://` install, pull the clone and then update or reinstall the same specification. + +## Contributor checks + +The behavioral runner uses the OpenCode 2 session API. It rejects partial text from failed or interrupted turns and accepts optional `provider/model#variant` references. Live runs need provider environment credentials; the isolated runtime does not copy the native V2 credential database. + ## Troubleshooting - If a new skill is missing, start a new host session and verify the expected `.agents/skills` destination. diff --git a/docs/skills/index.html b/docs/skills/index.html index 1cedcb4..260ff5f 100644 --- a/docs/skills/index.html +++ b/docs/skills/index.html @@ -3,7 +3,7 @@ - 54 Agent Skills Reference | OpenCode Power Pack + 55 Agent Skills Reference | OpenCode Power Pack - + - + - + - + @@ -42,434 +42,441 @@ href="https://fonts.googleapis.com/css2?family=Barlow+Condensed:wght@600;700;800&family=IBM+Plex+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" > - + @@ -484,7 +491,7 @@ @@ -508,10 +515,12 @@

    +

    The current main branch includes 55 skills, OpenCode 2.0 support, and humanizer. The published npm package and tag v0.5.0 still contain 54 skills and the V1-only plugin. Use the Git installation for the full OpenCode 2 plugin and humanizer. Read the compatibility guide.

    +

    Install one skill

    - Use npm when you want a selective set for Codex, OpenCode, or Pi. Node.js 20 or newer is + Use npm when you want a selective set for Codex, OpenCode, or Pi. Node.js 20.11.0 or newer is required. The default user destination is ~/.agents/skills.

    npx @waybarrios/opencode-power-pack install <skill-id> @@ -534,7 +543,7 @@ npx @waybarrios/opencode-power-pack install code-review

    Native Claude Code, Codex, OpenCode, and Pi plugin/package commands install the full catalog. - See the host installation guide when you want all 54 skills. + See the host installation guide when you want all 55 skills.

    @@ -556,7 +565,7 @@ npx @waybarrios/opencode-power-pack install code-review
    CORE

    Build, review, and author

    - 14 + 15
    @@ -934,9 +943,21 @@ npx @waybarrios/opencode-power-pack install code-review
    Host setup +
    +
    CORE / 12

    humanizer

    +
    What it does / when to use

    Rewrite English and Spanish copy in a direct, natural voice. Keep facts, names, numbers, URLs, and code intact.

    +
    Install from Git mainnpx --package=git+https://github.com/waybarrios/opencode-power-pack.git opencode-power-pack install humanizer
    +

    This runs the installer from Git main and installs into ~/.agents/skills. Add --dry-run to preview, or --project for the current repository. npm 0.5.0 does not include humanizer.

    +
    +
    Included by profiles
    authoring on main, alongside mcp-builder, paper-summarizer, and skill-creator.
    +
    Automatic companions
    None
    +
    Invoke after installation
    $humanizer in Codex, /humanizer in OpenCode, or /opencode-power-pack:humanizer in Claude Code.
    +
    + +
    - CORE / 12 + CORE / 13

    mcp-builder

    @@ -969,7 +990,7 @@ npx @waybarrios/opencode-power-pack install code-review
    - CORE / 13 + CORE / 14

    paper-summarizer

    @@ -1002,7 +1023,7 @@ npx @waybarrios/opencode-power-pack install code-review
    - CORE / 14 + CORE / 15

    skill-creator

    @@ -2377,6 +2398,6 @@ npx @waybarrios/opencode-power-pack install code-review
    - + diff --git a/docs/skills/index.md b/docs/skills/index.md index 02f8cb7..b2f692a 100644 --- a/docs/skills/index.md +++ b/docs/skills/index.md @@ -1,14 +1,16 @@ # OpenCode Power Pack: Complete Skill Reference -> Purpose, audience, profile membership, dependencies, install command, invocation, and source link for all 54 skills in v0.5.0. +> Purpose, audience, profile membership, dependencies, install command, invocation, and source link for all 55 skills on main. Canonical HTML browser: https://skills.waybarrios.com/docs/skills/ -Install any skill at user scope with `npx @waybarrios/opencode-power-pack install `. Add `--project` for repository-local scope or `--dry-run` to preview the resolved changes. +Install released skills at user scope with `npx @waybarrios/opencode-power-pack install `. Add `--project` for repository-local scope or `--dry-run` to preview the resolved changes. Required companion skills are installed automatically. Invoke an installed workflow as `$` in Codex, `/` in OpenCode, or `/opencode-power-pack:` in Claude Code. -## Core and authoring skills (14) +The current main branch includes 55 skills, OpenCode 2.0 support, and humanizer. The published npm package and tag v0.5.0 still contain 54 skills and the V1-only plugin. Use the Git installation for the full OpenCode 2 plugin and humanizer. + +## Core and authoring skills (15) ### agents-md-improver @@ -153,6 +155,19 @@ Create distinctive, production-grade frontend interfaces with high design qualit - HTML details: https://skills.waybarrios.com/docs/skills/#frontend-design - Source: https://github.com/waybarrios/opencode-power-pack/tree/main/skills/frontend-design +### humanizer + +Rewrite English and Spanish copy in a direct, natural voice. Keep facts, names, numbers, URLs, and code intact. + +- Profiles: `authoring` on main +- Automatic companions: None +- Install from source: `npx --package=git+https://github.com/waybarrios/opencode-power-pack.git opencode-power-pack install humanizer` +- Codex: `$humanizer` +- OpenCode 1 and 2: `/humanizer` +- Claude Code: `/opencode-power-pack:humanizer` +- HTML details: https://skills.waybarrios.com/docs/skills/#humanizer +- Source: https://github.com/waybarrios/opencode-power-pack/tree/main/skills/humanizer + ### mcp-builder Guide the creation of high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when the user wants to build an MCP server to integrate an external API or service, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). diff --git a/index.html b/index.html index 51e49b1..abd074b 100644 --- a/index.html +++ b/index.html @@ -3,10 +3,10 @@ - OpenCode Power Pack | 54 Skills for AI Coding Agents + OpenCode Power Pack | 55 Skills for AI Coding Agents @@ -21,7 +21,7 @@ - + - + @@ -62,118 +62,191 @@ href="https://fonts.googleapis.com/css2?family=Barlow+Condensed:wght@600;700;800&family=IBM+Plex+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" > - + @@ -181,7 +254,7 @@ @@ -209,13 +282,13 @@
    -

    [ OPEN SOURCE · v0.5.0 · MIT + APACHE-2.0 ]

    +

    [ OPEN SOURCE · MAIN · MIT + APACHE-2.0 ]

    One power pack.
    Every coding agent.

    - 54 portable Agent Skills for Claude Code, Codex, + 55 portable Agent Skills for Claude Code, Codex, OpenCode, and Pi. Install the workflows you need for code review, security, feature delivery, frontend craft, MCP authoring, and ML.

    @@ -299,6 +372,8 @@ Your goal is to understand what I need, recommend the smallest useful profile or set of individual skills, obtain my explicit selection, install it for the active coding-agent host, preserve all existing project work, and leave a reproducible verification report. +The npm procedure below uses the published catalog. OpenCode 2 can use those copied skills, but the native V2 plugin and humanizer require Git main. If I need either, show the current Git install guide and wait for my source choice before continuing. + Safety rules: 1. Do not modify package.json, package-lock.json, npm-shrinkwrap.json, pnpm-lock.yaml, yarn.lock, bun.lock, or application dependencies. 2. Do not use --force, --global, --all, sudo, destructive Git commands, or manual deletion/replacement of existing skill directories. Do not choose a profile or skill for me, and do not install anything before I explicitly approve the selection. @@ -319,7 +394,7 @@ Phase 2: preflight without changing repository files. 1. Print the current directory with pwd. 2. Run git rev-parse --show-toplevel. Stop if this is not a Git repository. Save the absolute Git root. -3. Run node --version. Parse the major version and require Node.js 20 or newer. If it is older or unavailable, stop and explain how to satisfy the prerequisite without changing this project. +3. Run node --version. Parse the full version and require Node.js 20.11.0 or newer. If it is older or unavailable, stop and explain how to satisfy the prerequisite without changing this project. 4. Run npm --version and stop if npm or npx is unavailable. 5. Capture git status --short before installation. Use it only as a baseline; do not alter any listed file. 6. State that the only permitted destination is <git-root>/.agents/skills. @@ -361,8 +436,9 @@ Phase 6: verify and report. 3. Run git status --short again and compare it with the saved baseline. Confirm that installation introduced no changes outside .agents/skills and did not change dependency manifests or lockfiles. Do not revert unrelated differences. 4. Tell the user to start a new agent session if the skills do not appear automatically. 5. Give the host-specific verification command: - - Codex: inspect /plugins, then invoke an installed skill such as $code-review. - - OpenCode: run opencode debug skill, then invoke /code-review. + - Codex: invoke an installed skill such as $code-review in a new session. Use /plugins only for a native plugin installation. + - OpenCode 1: run opencode debug skill, then invoke /code-review. + - OpenCode 2: check the skill picker, then invoke /code-review. - Pi: run pi list, then request a task that matches an installed workflow. 6. Finish with a concise structured report containing: stated need, approved selection and rationale, alternatives not chosen, host, Node/npm versions, Git root, destination, exact commands run, resolved skill count and names, installed entries, preserved/skipped entries, warnings or failures, worktree comparison, verification result, and any user action still required.
    @@ -387,7 +463,7 @@ Phase 6: verify and report.
    -
    54curated skills
    +
    55curated skills
    4agent hosts
    -
    400automated tests
    +
    418automated tests
    4sandbox profiles
    +
    +
    +

    New on main

    +

    OpenCode 2.0 and humanizer.

    +

    OpenCode 1.18.7, 2.0.14, and 2.0.32 load all 55 skills and three specialists. V2 permission checks keep the bundled specialists read-only.

    +

    Humanizer edits English and Spanish copy without changing the facts. The authoring profile now has four skills.

    +

    The published npm package and tag v0.5.0 still contain 54 skills and the V1-only plugin. Use Git main for OpenCode 2 and humanizer. See the install commands.

    +
    +
    +
    01 / PROFILES
    @@ -479,12 +565,12 @@ Phase 6: verify and report.
    -
    AUTHORING3 skills
    +
    AUTHORING4 skills on main

    Reusable agent tools

    -

    For: builders creating new Agent Skills, MCP servers, or engineering summaries from technical research.

    - Includes skill-creator, mcp-builder, and paper-summarizer. - npx @waybarrios/opencode-power-pack install --profile authoring - +

    For: builders creating new Agent Skills, MCP servers, technical-paper summaries, and clear English or Spanish copy.

    + Includes humanizer, skill-creator, mcp-builder, and paper-summarizer on main. + npx --package=git+https://github.com/waybarrios/opencode-power-pack.git opencode-power-pack install --profile authoring +
    @@ -524,9 +610,9 @@ Phase 6: verify and report.
    C -

    OpenCode

    -

    Native plugin loading plus least-privilege feature-development specialists.

    - opencode plugin --global "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git" +

    OpenCode 1 + 2

    +

    OpenCode 2.0 support on main, with three read-only specialists. OpenCode 1.18.7 still works.

    + opencode plugin add "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git"
    D @@ -542,12 +628,12 @@ Phase 6: verify and report.

    Searchable skill inventory

    -

    54 workflows. Three operational bands.

    +

    55 workflows. Three operational bands.

    @@ -557,7 +643,7 @@ Phase 6: verify and report.
    CORE

    Build, review, and author

    - 14 + 15
    • agents-md-improver
    • @@ -571,6 +657,7 @@ Phase 6: verify and report.
    • design-patterns
    • feature-dev
    • frontend-design
    • +
    • humanizer
    • mcp-builder
    • paper-summarizer
    • skill-creator
    • @@ -646,15 +733,15 @@ Phase 6: verify and report.

      Curated means verified

      Portable workflows with an evidence trail.

      - This is not a bulk mirror. Skills are reviewed, adapted for cross-host behavior, and - shipped with provenance, notices, licenses, host validation, and regression coverage. + Each workflow has source records and checks for the hosts it supports. The repository is + shipped with provenance, notices, licenses, host checks, and regression tests.

        -
      1. 0154 / 54 official Agent Skills validations
      2. -
      3. 02400 automated behavioral, packaging, and sandbox tests
      4. +
      5. 0155 / 55 official Agent Skills validations
      6. +
      7. 02418 automated behavioral, packaging, and sandbox tests
      8. 03Strict Claude plugin and marketplace validation
      9. -
      10. 04Minimum + latest OpenCode smoke coverage
      11. +
      12. 04OpenCode 1 + 2 OpenCode smoke coverage
      13. 05Immutable upstream provenance and license records
      @@ -690,6 +777,10 @@ Phase 6: verify and report. small changes and feature-development handoffs.

      +
      + Does the plugin support OpenCode 2.0? +

      Yes. Install from Git main with opencode plugin add. The same plugin supports OpenCode 1.18.7 through plugin --global. npm 0.5.0 predates the V2 port. Read the compatibility guide.

      +
      Can I install only one skill?

      @@ -737,9 +828,9 @@ Phase 6: verify and report. AI summary License - v0.5.0 // 2026 + MAIN // 2026 - + diff --git a/index.md b/index.md index 6d50cb0..da418e5 100644 --- a/index.md +++ b/index.md @@ -1,6 +1,14 @@ # OpenCode Power Pack -OpenCode Power Pack is an open-source collection of 54 portable Agent Skills for Claude Code, Codex, OpenCode, and Pi. The current release is v0.5.0. +OpenCode Power Pack is an open-source collection of 55 portable Agent Skills for Claude Code, Codex, OpenCode, and Pi. This page follows main. The latest published release is v0.5.0. + +## OpenCode 2.0 and humanizer + +The current main branch includes 55 skills, OpenCode 2.0 support, and humanizer. The published npm package and tag v0.5.0 still contain 54 skills and the V1-only plugin. Use the Git installation for the full OpenCode 2 plugin and humanizer. + +OpenCode 2 uses `opencode plugin add "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git"`. OpenCode 1 uses `opencode plugin --global "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git"`. Both load 55 skills and three specialists from main. + +Humanizer edits English and Spanish copy without changing facts, names, numbers, URLs, or code. It joins mcp-builder, paper-summarizer, and skill-creator in the four-skill authoring profile. ## Start here @@ -12,7 +20,7 @@ OpenCode Power Pack is an open-source collection of 54 portable Agent Skills for ## Install -The selective npm installer requires Node.js 20 or newer. +The selective npm installer requires Node.js 20.11.0 or newer. ```sh # See every skill and profile @@ -40,7 +48,7 @@ To delegate installation to a coding agent, use the safe dry-run-first prompt an | `frontend` | Frontend developers and designers | Interface implementation and anti-generic design critique | | `security` | AppSec engineers and security-conscious maintainers | Review, threat modeling, scanning, validation, and reporting | | `huggingface` | ML engineers and researchers | Discovery, inference, training, evaluation, Spaces, and AWS deployment | -| `authoring` | Builders of reusable agent tools | Agent Skills, MCP servers, and paper summarization | +| `authoring` | Builders of reusable agent tools | Agent Skills, MCP servers, paper summaries, and copy editing on main | | `project-memory` | Teams maintaining durable agent context | AGENTS.md and CLAUDE.md improvement and revision | Install a profile with: @@ -53,7 +61,7 @@ npx @waybarrios/opencode-power-pack install --profile - Claude Code uses namespaced plugin skills such as `/opencode-power-pack:code-review`. - Codex invokes installed workflows with names such as `$code-review`. -- OpenCode invokes installed workflows with names such as `/code-review`. +- OpenCode 1 and 2 invoke installed workflows with names such as `/code-review`. Install the current Git plugin for OpenCode 2. - Pi exposes the package's declared skills directory. ## Review workflows @@ -80,10 +88,10 @@ Codex, OpenCode, Claude Code, and Pi can all invoke the manual runner. Automatic ## Quality signals -- 54 of 54 official Agent Skills validations pass. -- 400 automated behavioral, packaging, and sandbox tests are defined at v0.5.0. +- 55 of 55 official Agent Skills validations pass. +- The main branch defines 418 tests. The latest local run passed 417 and skipped the optional native sandbox integration test. - Claude plugin and marketplace metadata receive strict validation. -- OpenCode has minimum-version and latest-version smoke coverage. +- Smoke tests cover OpenCode 1.18.7, 2.0.14, and 2.0.32, including effective V2 permission checks. - Third-party workflows include immutable provenance, notices, and license records. OpenCode Power Pack is MIT AND Apache-2.0 licensed, subject to the per-skill provenance and notices in the repository. diff --git a/llms-full.txt b/llms-full.txt index 75e19bf..fc7dcd4 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -1,8 +1,8 @@ # OpenCode Power Pack: Expanded Documentation -> Canonical, machine-readable project facts for OpenCode Power Pack v0.5.0. Last updated 2026-08-17. +> Canonical, machine-readable project facts for the current main branch of OpenCode Power Pack. Last updated 2026-10-19. -OpenCode Power Pack is an open-source collection of 54 portable Agent Skills for Claude Code, Codex, OpenCode, and Pi. It packages repeatable workflows for software development, code review, application security, frontend design, MCP authoring, project memory, and Hugging Face machine-learning work. +OpenCode Power Pack is an open-source collection of 55 portable Agent Skills for Claude Code, Codex, OpenCode, and Pi. It packages repeatable workflows for software development, code review, application security, frontend design, MCP authoring, project memory, and Hugging Face machine-learning work. Canonical website: https://skills.waybarrios.com/ Documentation: https://skills.waybarrios.com/docs/ @@ -13,13 +13,21 @@ Release: https://github.com/waybarrios/opencode-power-pack/releases/tag/v0.5.0 Author: Wayner Barrios License: MIT AND Apache-2.0, with per-skill provenance and notices +## OpenCode 2.0 and humanizer + +The current main branch includes 55 skills, OpenCode 2.0 support, and humanizer. The published npm package and tag v0.5.0 still contain 54 skills and the V1-only plugin. Use the Git installation for the full OpenCode 2 plugin and humanizer. + +OpenCode 2 install: `opencode plugin add "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git"`. OpenCode 1 install: `opencode plugin --global "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git"`. + +Both hosts load all 55 skills and three specialists from main. Install humanizer selectively with `npx --package=git+https://github.com/waybarrios/opencode-power-pack.git opencode-power-pack install humanizer`. Invoke it with `$humanizer` in Codex, `/humanizer` in OpenCode, or `/opencode-power-pack:humanizer` in Claude Code. It edits English and Spanish copy while keeping facts, names, numbers, URLs, and code intact. + ## What an Agent Skill is An Agent Skill is a reusable workflow centered on a SKILL.md file. It can include durable instructions, decision rules, references, scripts, and examples for a specific task. The workflow ID stays stable across supported coding agents, while packaging and invocation follow each host's conventions. ## Selective npm installation -Requirement: Node.js 20 or newer. +Requirement: Node.js 20.11.0 or newer. List skills and profiles: @@ -45,7 +53,7 @@ Install the recommended profile: npx @waybarrios/opencode-power-pack install --profile recommended -Install all 54 skills: +Install every skill in the published npm catalog: npx @waybarrios/opencode-power-pack install --all @@ -100,7 +108,7 @@ Compatibility specification: https://github.com/waybarrios/opencode-power-pack/b - frontend: frontend-design and ai-slop. - security: 15 security review, threat-modeling, static-analysis, validation, and reporting workflows. - huggingface: 25 discovery, inference, training, evaluation, Spaces, and AWS deployment workflows. -- authoring: mcp-builder, paper-summarizer, and skill-creator. +- authoring on main: humanizer, mcp-builder, paper-summarizer, and skill-creator. npm 0.5.0 contains the three earlier authoring skills. - project-memory: agents-md-improver and agents-md-revise. Install any profile with: @@ -117,9 +125,9 @@ Install any profile with: ## Complete skill inventory -Every skill can be installed with `npx @waybarrios/opencode-power-pack install `. Purpose, dependencies, profiles, host invocation, and source links are available at `https://skills.waybarrios.com/docs/skills/#`. +Released skills can be installed with `npx @waybarrios/opencode-power-pack install `. Purpose, dependencies, profiles, host invocation, and source links, including the Git-only humanizer install, are available at `https://skills.waybarrios.com/docs/skills/#`. -### Core and authoring skills (14) +### Core and authoring skills (15) 1. agents-md-improver: audits and improves AGENTS.md, CLAUDE.md, and related project-rules files. 2. agents-md-revise: captures session learnings into durable project rules. @@ -132,9 +140,10 @@ Every skill can be installed with `npx @waybarrios/opencode-power-pack install < 9. design-patterns: evaluates pattern trade-offs for Rust, TypeScript, React, Django, and Python. 10. feature-dev: coordinates a structured end-to-end feature implementation workflow. 11. frontend-design: creates distinctive, production-grade frontend interfaces. -12. mcp-builder: designs and builds Model Context Protocol servers. -13. paper-summarizer: analyzes academic and technical papers for engineering decisions. -14. skill-creator: creates or improves reusable Agent Skills and their trigger descriptions. +12. humanizer: rewrites English and Spanish copy while preserving facts, names, numbers, URLs, and code. +13. mcp-builder: designs and builds Model Context Protocol servers. +14. paper-summarizer: analyzes academic and technical papers for engineering decisions. +15. skill-creator: creates or improves reusable Agent Skills and their trigger descriptions. ### Security skills (15) @@ -184,10 +193,10 @@ Every skill can be installed with `npx @waybarrios/opencode-power-pack install < ## Quality and provenance -- 54 of 54 skills pass official Agent Skills validation. -- The repository defines 400 automated behavioral, packaging, and sandbox tests at v0.5.0. +- 55 of 55 skills pass official Agent Skills validation. +- The main branch defines 418 tests. The latest local run passed 417 and skipped the optional native sandbox integration. - Claude plugin and marketplace metadata receive strict validation. -- OpenCode receives minimum-version and latest-version smoke coverage. +- OpenCode smoke tests cover 1.18.7, 2.0.14, and 2.0.32, including effective read-only permissions on V2. - Third-party workflows have immutable upstream references, notices, and license records. Evidence and exact provenance live in the repository: @@ -199,7 +208,7 @@ Evidence and exact provenance live in the repository: ## Citation and factual boundaries Preferred project name: OpenCode Power Pack. -Current documented version: 0.5.0. +Current documentation: main. Latest published release: 0.5.0. Canonical URL: https://skills.waybarrios.com/ Repository: https://github.com/waybarrios/opencode-power-pack Package: @waybarrios/opencode-power-pack diff --git a/llms.txt b/llms.txt index 71fab14..fade0db 100644 --- a/llms.txt +++ b/llms.txt @@ -1,8 +1,8 @@ # OpenCode Power Pack -> OpenCode Power Pack v0.5.0 is an open-source collection of 54 portable Agent Skills for Claude Code, Codex, OpenCode, and Pi, with an opt-in native sandbox runner for contained commands. +> OpenCode Power Pack on main is an open-source collection of 55 portable Agent Skills for Claude Code, Codex, OpenCode, and Pi, with an opt-in native sandbox runner for contained commands. -The project provides reusable workflows for code review, security auditing, feature development, frontend design, MCP authoring, project memory, and Hugging Face machine-learning work. Its npm package is `@waybarrios/opencode-power-pack`. The selective installer requires Node.js 20 or newer and provides eight curated profiles. +The project provides reusable workflows for code review, security auditing, feature development, frontend design, MCP authoring, project memory, and Hugging Face machine-learning work. Its npm package is `@waybarrios/opencode-power-pack`. The selective installer requires Node.js 20.11.0 or newer and provides eight curated profiles. Install one skill with `npx @waybarrios/opencode-power-pack install `. Install the recommended profile with `npx @waybarrios/opencode-power-pack install --profile recommended`. List every skill and profile with `npx @waybarrios/opencode-power-pack list`. @@ -10,21 +10,29 @@ The `code-review` workflow performs a comprehensive review of a pull request or The manual sandbox runner works from Codex, OpenCode, Claude Code, and Pi on supported macOS and Linux hosts. It contains the explicitly selected command and its descendants. Automatic host routing and whole-agent isolation are not yet implemented. -When citing the project, use “OpenCode Power Pack,” version 0.5.0, author Wayner Barrios, canonical URL `https://skills.waybarrios.com/`, and repository `https://github.com/waybarrios/opencode-power-pack`. +When citing the project, use “OpenCode Power Pack,” the main branch or a specific release tag, author Wayner Barrios, canonical URL `https://skills.waybarrios.com/`, and repository `https://github.com/waybarrios/opencode-power-pack`. + +## OpenCode 2.0 and humanizer + +The current main branch includes 55 skills, OpenCode 2.0 support, and humanizer. The published npm package and tag v0.5.0 still contain 54 skills and the V1-only plugin. Use the Git installation for the full OpenCode 2 plugin and humanizer. + +OpenCode 2 install: `opencode plugin add "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git"`. OpenCode 1 install: `opencode plugin --global "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git"`. + +Both hosts load all 55 skills and three specialists from main. Invoke humanizer with `$humanizer` in Codex, `/humanizer` in OpenCode, or `/opencode-power-pack:humanizer` in Claude Code. It edits English and Spanish copy while keeping facts, names, numbers, URLs, and code intact. ## Documentation - [Project overview](https://skills.waybarrios.com/index.md): Product purpose, supported hosts, install paths, profiles, and quality signals. - [Installation, sandbox, and operations](https://skills.waybarrios.com/docs/index.md): npm commands, host setup, contained command execution, profile selection, updates, removal, and troubleshooting. - [Agent installation guide](https://skills.waybarrios.com/agent-install.md): Safe dry-run-first instructions and a copyable prompt for an agent to perform the installation. -- [Complete 54-skill reference](https://skills.waybarrios.com/docs/skills/index.md): Purpose, audience, profile membership, dependencies, install command, and source link for every skill. +- [Complete 55-skill reference](https://skills.waybarrios.com/docs/skills/index.md): Purpose, audience, profile membership, dependencies, install command, and source link for every skill. - [Expanded project reference](https://skills.waybarrios.com/llms-full.txt): Single-file project facts, commands, profiles, inventory, provenance, and citation guidance. ## Source and distribution - [GitHub repository](https://github.com/waybarrios/opencode-power-pack#readme): Canonical source code and human documentation. - [npm package](https://www.npmjs.com/package/@waybarrios/opencode-power-pack): Public selective installer package. -- [Release v0.5.0](https://github.com/waybarrios/opencode-power-pack/releases/tag/v0.5.0): Current documented release. +- [Release v0.5.0](https://github.com/waybarrios/opencode-power-pack/releases/tag/v0.5.0): Latest published release, before OpenCode 2 support and humanizer. - [Upstream provenance](https://github.com/waybarrios/opencode-power-pack/blob/main/UPSTREAMS.json): Immutable source references for adapted workflows. ## Optional diff --git a/site.webmanifest b/site.webmanifest index 36f7ad5..cce8e52 100644 --- a/site.webmanifest +++ b/site.webmanifest @@ -1,7 +1,7 @@ { "name": "OpenCode Power Pack", "short_name": "Power Pack", - "description": "Fifty-four portable Agent Skills for Claude Code, Codex, OpenCode, and Pi.", + "description": "Fifty-five portable Agent Skills for Claude Code, Codex, OpenCode, and Pi.", "start_url": "/", "scope": "/", "display": "standalone", diff --git a/sitemap.xml b/sitemap.xml index 4f2c633..25b8ab7 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -5,23 +5,23 @@ > https://skills.waybarrios.com/ - 2026-08-17 + 2026-10-19 weekly 1.0 https://skills.waybarrios.com/assets/social-card.png - OpenCode Power Pack: 54 skills for four coding agents + OpenCode Power Pack: 55 skills for four coding agents https://skills.waybarrios.com/docs/ - 2026-08-17 + 2026-10-19 weekly 0.9 https://skills.waybarrios.com/docs/skills/ - 2026-08-17 + 2026-10-19 weekly 0.9