agent-tools

Agent tooling packages - pi extensions, agent skills, and more.

Packages

Pi Extensions

Package	Description	Install
@walterra/pi-charts	Vega-Lite chart extension for pi	pi install npm:@walterra/pi-charts
@walterra/pi-graphviz	Graphviz DOT diagram extension for pi	pi install npm:@walterra/pi-graphviz

Agent Skills

Universal agent skills compatible with Cursor, Claude Code, Codex, Pi, and other agents following the Agent Skills specification.

Skill	Description
es-ingest	Deprecated in this repo. Use official elasticsearch-file-ingest in elastic/agent-skills.
git-commit	Commit staged files with precise messages, safe pre-commit hook handling
post-mortem	Analyze chat sessions to improve project rules and skills
searxng-search	Web search via SearXNG - no API keys, no rate limits

Deprecations

• es-ingest is deprecated in this repository.
• Official replacement: elasticsearch-file-ingest
• Install replacement via: npx skills add elastic/agent-skills --skill elasticsearch-file-ingest

Install Skills

From GitHub

# Using npx skills (Vercel)
npx skills add walterra/agent-tools --skill git-commit
npx skills add walterra/agent-tools --skill post-mortem
npx skills add walterra/agent-tools --skill searxng-search

# Official Elastic file ingest skill (replacement for deprecated es-ingest)
npx skills add elastic/agent-skills --skill elasticsearch-file-ingest

# Install directly to pi from a subpath (one command)
npx skills add https://github.com/walterra/agent-tools/tree/main/packages/git-commit -a pi -g
npx skills add https://github.com/walterra/agent-tools/tree/main/packages/post-mortem -a pi -g
npx skills add https://github.com/walterra/agent-tools/tree/main/packages/searxng-search -a pi -g
npx skills add https://github.com/elastic/agent-skills/tree/main/skills/elasticsearch/elasticsearch-file-ingest -a pi -g

# Using ai-agent-skills
npx ai-agent-skills install walterra/agent-tools

# Install to specific agents
npx skills add walterra/agent-tools --skill git-commit -a cursor -a claude-code
npx skills add walterra/agent-tools --skill post-mortem -a cursor -a claude-code
npx skills add walterra/agent-tools --skill searxng-search -a cursor -a claude-code
npx skills add elastic/agent-skills --skill elasticsearch-file-ingest -a cursor -a claude-code

Some skills require setup after installation (e.g. npm install for skills with dependencies). git-commit and post-mortem are pure markdown and need no setup. For skills with dependencies in this repo:

cd ~/.cursor/skills/searxng-search && npm install

For Elastic's replacement ingest skill, follow setup instructions in: https://github.com/elastic/agent-skills/tree/main/skills/elasticsearch/elasticsearch-file-ingest

Manual Installation

git clone https://github.com/walterra/agent-tools.git
cp -r agent-tools/packages/searxng-search ~/.cursor/skills/
cd ~/.cursor/skills/searxng-search && npm install

Skill Directories by Agent

Agent	Global Path
Cursor	~/.cursor/skills/
Claude Code	~/.claude/skills/
Codex	~/.codex/skills/
Pi	~/.pi/agent/skills/
Copilot	~/.copilot/skills/

Package Naming Convention

Package	Target	Distribution
@walterra/pi-*	pi-coding-agent	Published to npm
Skills	Cursor, Claude Code, Codex, Pi, etc.	GitHub only (not published to npm)

Development

# Install dependencies (also installs git hooks via Husky)
pnpm install

# Fast local fix
pnpm lint:fix

# Match CI quality gate locally (frozen lockfile + lint + build)
pnpm verify

Git hooks:

• pre-commit: runs pnpm lint
• pre-push: runs pnpm verify

License

MIT