Files
nix-config/agents/install-tooling.md
T

104 lines
3.2 KiB
Markdown

# Agent Tooling Commands
Reference commands for installing external agent tooling: skills via `npx skills`, the `ctx7` docs
tool, and the tuios harness integration. Keep the global set small and install task-specific skills
in the relevant project.
This repository's own skills live in `.agents/skills/`: they are tracked in git and discovered
automatically, so do not install, overwrite, or remove them with `npx skills`. The commands below
are for external and global skills.
## Inspect and update installed skills
```bash
# list all installed skills (project + global)
npx skills list
# list only global skills
npx skills ls -g
# check for updates
npx skills check
# update all installed skills
npx skills update
```
## Discover skills from repositories
```bash
# list skills in a repository
npx skills add anthropics/skills --list
```
## Global baseline
```bash
# structured planning, testing, debugging, review, and verification workflows
npx skills add -g obra/superpowers --skill '*'
# discover task-specific skills when needed
npx skills add -g vercel-labs/skills --skill 'find-skills'
```
`find-docs` is also installed globally from a local source, so it has no upstream install command.
## Optional global skills
```bash
# rewrite prose to sound natural while preserving claims and technical meaning
npx skills add -g blader/humanizer --skill 'humanizer'
# review code for unnecessary abstractions and over-engineering
npx skills add -g DietrichGebert/ponytail --skill 'ponytail-review'
# enable a terse response mode when context or token usage matters
npx skills add -g JuliusBrussee/caveman --skill 'caveman'
# shape replies for an ADHD reader: next action first, numbered steps, restated state
npx skills add -g ayghri/i-have-adhd --skill 'i-have-adhd'
```
## Optional project skills
Run these commands from the project root. They intentionally omit `-g`, so the skills apply only to
the current project. Check `git status` after installation and commit the generated files only when
the whole team should use them.
```bash
# design distinctive UI and demo pages
npx skills add anthropics/skills --skill 'frontend-design'
# test local web applications with Playwright
npx skills add anthropics/skills --skill 'webapp-testing'
# read, create, edit, or validate PDF files
npx skills add anthropics/skills --skill 'pdf'
# run CodeQL and Semgrep on repositories written in supported languages; not for pure Nix projects
npx skills add trailofbits/skills --skill 'codeql' --skill 'semgrep'
```
## Other agent tooling
```bash
# context7: up-to-date library docs and code examples for LLMs and agents
npx ctx7 setup
# tuios: register it as an MCP server for the harness (read-only, or --mcp-write
# for typing tools); also reports agent state into the tuios pane
tuios integration install opencode --mcp-write
```
References:
- https://github.com/obra/superpowers
- https://github.com/vercel-labs/skills
- https://github.com/blader/humanizer
- https://github.com/DietrichGebert/ponytail
- https://github.com/JuliusBrussee/caveman
- https://github.com/ayghri/i-have-adhd
- https://github.com/Gaurav-Gosain/tuios
- https://github.com/anthropics/skills
- https://github.com/trailofbits/skills