nix-config/agents/install-tooling.md

Agent Tooling Commands

Reference commands for project-scoped skills and other external agent tooling. Global skills are not installed here: they are pinned flake inputs or live in agents/skills/, deployed by Home Manager; see skills/README.md. Do not install global skills with npx skills add -g; its copies collide with the Home Manager links in ~/.agents/skills.

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.

Discover skills from repositories

# list skills in a repository without installing anything
npx skills add anthropics/skills --list

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.

# 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
# (CC-BY-SA-4.0: copies and modifications carry attribution and the same license)
npx skills add trailofbits/skills --skill 'codeql' --skill 'semgrep'

Other agent tooling

# 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/vercel-labs/skills
• https://github.com/Gaurav-Gosain/tuios
• https://github.com/anthropics/skills
• https://github.com/trailofbits/skills