v1.2.0 · OpenCode Plugin

$ autoskills
detect & install
AI skills, fast.

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

$npx opencode-autoskills setup
Built by encode90 · powered by autoskills

01System Architecture

Reduce setup time for the current OpenCode project. No manual installs, no repeated prompts — just guided detection and one-click selection.

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 name or list number. Answer with “keep 1, 3, 4” or “all except 2” — the tool understands.

Time Savings

Detection and installation happen in one guided flow. Spend less time searching, copying commands, and cleaning up later.

02Features

Real Tool Execution

The custom OpenCode tool runs detection and installation for real — no prompt-only suggestions.

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. 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.

Company Skills

Add your company conventions and tools as local skills via .autoskills.json. Local skills override public ones with the same name.

Multi-Platform

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

03Internal Skills

Ship your company conventions, tools, and patterns as AI skills alongside public autoskills. Local skills take priority over public ones with the same name.

.autoskills.json
{
  "sources": [
    { "type": "local", "path": "./skills-empresa" }
  ]
}
skills-empresa/
skills-empresa/
├── company-api-patterns/
│   └── SKILL.md
├── company-database/
│   └── SKILL.md
└── company-deploy/
    └── SKILL.md
Detect output
--- Local sources ---
./skills-empresa:
  - company-api-patterns
  - company-database

--- Public ---
vitest, react-testing, typescript

04Installation & Usage

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

$ terminal — global setup
$ npx opencode-autoskills setup
$ terminal — per-project setup
$ npx opencode-autoskills setup --local
> OpenCode — usage
/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

05Configuration

Requirements, paths, and environment variables.

Setting Description
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).
.autoskills.json Optional config file for declaring local skill sources. Place in project root.