Skills

My skills toolbelt.

My dotfiles-like repo for agent skills: a small, opinionated toolkit I want available wherever I work.

The repository is an Agent Plugins v1 package. The root plugin.json is the portable manifest, and clients discover its skills from the fixed skills/ directory.

The idea

Global by default, useful on demand, and personal enough to evolve with the way I work.

The skills here are the reusable utilities that make an agent feel more at home in a terminal-finding the right command, understanding an unfamiliar CLI, and creating safe, version-aware configuration. They are packaged independently so I can install the whole collection globally or pick only what I need.

Design principles

The skills are designed to:

• be as safe and deterministic as possible;
• have non-destructive behavior and require explicit user consent before applying changes on disk;
• use Internet search only when required by the skill (e.g. documentation lookup);
• work in a read-only manner while gathering information and providing guidance;
• be portable and self-contained, with no external dependencies beyond Python 3.8+ and the standard library;
• be compatible with Bash and zsh, and avoid shell-specific features when possible;
• where possible, be usable in a non-interactive context, with no prompts or interactive input;
• be installed globally for a user account, but not require elevated privileges or root access;
• have checks and tests to prevent regressions.

What's inside

Each skill is a self-contained package with a SKILL.md workflow and, where useful, supporting references, scripts, and tests.

Install

Install the full toolkit for your user account with the skills CLI:

npx skills add pirafrank/skills --all --global

Or install just the utilities you want:

npx skills add pirafrank/skills \
  --skill find-tool \
  --skill mangpt \
  --global

The CLI uses symlinks by default, which suits a dotfiles-style setup. Use --copy when symlinks are not a good fit for your environment. Update the installed collection with:

npx skills update

Client installation and compatibility

The portable core is the root plugin.json plus skills/<name>/SKILL.md. Clients that implement Agent Plugins v1 discover those skills from the fixed skills/ directory. Host-specific mirrors and marketplace files remain available as compatibility paths.

Claude Code

Add this repository as a Claude Code marketplace and install the bundled plugin:

/plugin marketplace add pirafrank/skills
/plugin install pirafrank-skills@pirafrank

Claude marketplace metadata lives under .claude-plugin/. The agents/ directory contains named-agent definitions for hosts that support them; it is not part of the portable v1 core.

GitHub Copilot CLI, VS Code, and Copilot app

Copilot CLI can register and browse the marketplace before installing the plugin:

copilot plugin marketplace add pirafrank/skills
copilot plugin marketplace browse pirafrank
copilot plugin install pirafrank-skills@pirafrank

For a local checkout, replace the repository reference with /path/to/skills. Copilot in VS Code and the Copilot app can use the same Agent Skills; use their plugin/customizations UI when available, or copy the selected skill directories into the documented project or user skill directory. See the Copilot CLI plugin reference and VS Code Agent Skills guide.

OpenAI Codex

Codex supports Agent Skills and plugins. For local repository use, run Codex from this checkout or link/copy its skill directories into the repository or user discovery location:

mkdir -p .agents/skills
for skill in skills/*; do
  [ -d "$skill" ] && ln -sfn "$(pwd)/$skill" ".agents/skills/$(basename "$skill")"
done

Then use /skills to inspect available skills or $skill-name to invoke one explicitly. Codex can also install individual curated skills through $skill-installer; the Codex skills guide documents discovery locations and plugin distribution.

Cursor and Cursor CLI

Cursor supports the Agent Skills standard and discovers project skills from .cursor/skills/ and .agents/skills/. From a checkout of this repository, use the same symlink approach shown for Codex, targeting .cursor/skills/, or install the collection with the skills CLI:

npx skills add pirafrank/skills --all --global

In Cursor, type / in Agent chat to find a skill. The Cursor Agent Skills guide covers project/user discovery and CLI behavior.

Google Antigravity CLI (agy)

Antigravity CLI supports plugin bundles containing plugin.json and skills/. Use Antigravity's plugin installer/manager when available, then verify the skills with /skills. Its documented staged layout is:

~/.gemini/antigravity-cli/plugins/pirafrank-skills/
├── plugin.json
└── skills/

If your agy version has no remote marketplace installer, clone or download this repository and stage that checkout at the path above, then restart agy. See the Antigravity CLI plugin documentation.

Vercel CLI

The vercel command-line tool deploys and manages Vercel projects; it is not itself an Agent Plugins or Agent Skills harness, so it has no native plugin-install command. Use this package through a supported coding agent (such as Claude Code, Cursor, Codex, or Copilot) while using the Vercel CLI for project operations. Vercel's own plugin documentation currently lists Claude Code, Cursor, and Codex as supported plugin hosts; its MCP integration supports a broader set of clients.

Other compatible clients

The Agent Plugins compatible-clients directory lists current support. In addition to the clients above, it currently documents Agent Skills support for Kiro, Hermes Agent, OpenClaw, Grok Bot, and NanoClaw. Use each client's setup instructions to install a plugin or add the repository's skills/ directory to its supported skill location. Any harness implementing the Agent Skills standard can consume the individual SKILL.md directories even if it does not yet implement the complete plugin marketplace flow.

Repository layout

skills/
├── dotfiles-config/
├── find-tool/
├── mangpt/
└── rust-developer/

plugin.json         # Agent Plugins v1 portable manifest
agents/             # client-specific named agents (not v1 portable core)
agent/skills/       # host-specific mirror
.agents/skills/     # host-specific mirror
.claude/skills/     # host-specific mirror
.claude-plugin/     # Claude/Copilot marketplace metadata
tests/              # deterministic tests and per-skill checks

The portable workflow lives in each skill's SKILL.md. Host-specific mirrors hold integrations for the environments where the skill is exposed.

Test the collection

Run the deterministic test suite from the repository root:

python3 -m unittest discover -s tests -p 'test_*.py' -v

When adding a skill, create skills/<skill-name>/SKILL.md with a lowercase, hyphenated name, add any required host mirrors, and keep its testing notes under tests/<skill-name>/.

Disclaimer

Even with the above design principles in mind, I cannot guarantee that the skills will never do something unexpected, so please use them with care and review their output before acting on it.

Do NOT run the skills as root or with elevated privileges.

Do NOT run them in a shell where you have unsaved work or uncommitted changes you don't want to lose. Make a backup, commit, or stash them first.

Content of this repository is provided as-is, with NO WARRANTY. Use at your own risk.

License

This repository is licensed under the MIT License. See LICENSE for details.