v1.0.3 · OpenCode Plugin

One setup.
Less friction.
Skills ready faster.

An OpenCode workflow by encode90 that detects suggested skills, lets you choose them in natural language, and installs only what your current project needs.

$npx opencode-autoskills setup
Built by encode90 for faster OpenCode project setup

01System Architecture

The goal is simple: reduce setup time for the current OpenCode project without forcing you through manual installs and repeated prompts.

Project-Focused Workflow

Run one command, review the detected stack, and keep only the skills that make sense for the current repo.

🪡

Natural-Language Selection

Choose by directory name or by list number. You can answer things like “keep 1, 3, 4” or “all except 2”.

🪙

Time Savings

Detection and installation happen in one guided flow so you spend less time searching, copying commands, and cleaning unwanted skills later.

02Features

Real Tool Execution

The custom OpenCode tool runs detection and installation for real instead of returning a prompt-only suggestion.

Less Context Switching

Stay inside OpenCode: detect, review, choose, and install without leaving the current workflow.

Flexible Selection

Reply with natural language or with list numbers. The flow supports exact names and phrases like “all except 2”.

Global or Per-Project

Setup once globally, or keep it scoped with --local for a single repository.

Security First

No postinstall scripts. Minimal runtime surface. Path traversal prevention in setup.

Multi-Platform

Windows, macOS, and Linux. CI-tested on all three with GitHub Actions.

03Installation & Usage

One-time setup. Then use /autoskills and answer with names or list numbers.

Terminal — Setup (global, one time)
$ npx opencode-autoskills setup
Terminal — Per-project setup
$ npx opencode-autoskills setup --local
OpenCode TUI — After setup
/autoskills

# Or just tell the agent:
> install skills for this project

# After detection, answer like:
> keep 1, 3, 4
> keep vitest, accessibility
> all except 2
What happens next
→ OpenCode invokes the autoskills tool
→ The tool runs real dry-run detection
→ You answer with names or numbers
→ The tool installs and filters the final set
→ Installed to .agents/skills/
→ OpenCode discovers them automatically

04Configuration

Environment variables and requirements.

Variable / SettingDescription
Node.js Required >= 22.6.0
@opencode-ai/plugin Peer dependency >= 1.0.0 (provided by OpenCode)
global Default setup mode. Writes the command file globally and registers the npm plugin in OpenCode config.
--local Setup flag. Creates .opencode/commands/ and a local plugin wrapper for the current project
opencode.json Global setup adds opencode-autoskills to the OpenCode plugin array so the custom tool is available
.agents/skills/ Skills install path (autoskills default, OpenCode compatible)
GITHUB_TOKEN Optional. Passed through to autoskills for increased API rate limits