Frank
651924a4bc
Three parallel trees documented the same ecosystem: omp-docs/skills/
(two overview pages), tools/npx-skills/ (10 pi-era npm pages), and
tools/vercel-labs-skills/ (11 CLI pages), plus a fourth leaderboard page
at engineering/skills-ecosystem.md. Verbatim overlap (identical SKILL.md
field tables in skills-spec.md vs skill-format.md; 13-agent vs 68-agent
copies of the same upstream table). Consolidated to four concept pages:
- skills/agent-skills.md: standard, format, loading, authoring (merges
skills-spec, skill-format, skill-file-structure, skill-loading,
best-practices, skills-vs-extensions)
- skills/skills-cli.md: CLI reference (merges commands, source-formats,
installation-scope, skill-discovery, lock-file, env-variables,
agent-support, related-links)
- skills/store-wiring.md: moved, fleet ops, links retargeted
- skills/ecosystem.md: replaces skills-ecosystem.md; stale 2026-08-12
top-50 table dropped, replaced with a live top-10 re-queried from the
skills.sh API tonight and the API contract re-verified (zero-based,
200/page, {skills,total,hasMore,page}, total 9909)
All facts re-verified 2026-10-19 against primary sources:
agentskills.io, vercel-labs/skills README + src/cli.ts (command set,
--full-depth) + src/skill-lock.ts (v3 lock, XDG path, wipe-on-old),
live skills.sh API. Deleted superseded core/index-doc.md (old pi-era
docs index). Retargeted all inbound links (tools/index, engineering x3,
packages x3, pi/skills, core/index). Pi-era npm skill packaging is
listed as archived under /pi/.
Refs #29
2.0 KiB
2.0 KiB
type, title, description, tags, timestamp
| type | title | description | tags | timestamp | ||||
|---|---|---|---|---|---|---|---|---|
| index | Pi Skills | Documentation for installed agent skills — code-review, diagnosing-bugs, find-skills, grilling, handoff, implement, obsidian-vault, prototype, tdd, teach, writing-great-skills, writing-guidelines, and zim-knowledge-base. |
|
2026-08-28 |
Pi Skills
Agent skills teach the agent new workflows. Skills are stored in ~/.pi/agent/skills/ (local) and symlinked from ~/.agents/skills/.
Installed Skills
| Skill | Source | Description |
|---|---|---|
| code-review | Local | Two-axis review: Standards and Spec, parallel sub-agents |
| diagnosing-bugs | Symlinked (.agents) | Diagnosis loop for hard bugs and performance regressions |
| find-skills | Symlinked (.agents) | Discover and install agent skills from the ecosystem |
| grilling | Symlinked (.agents) | Stress-test a plan or design before building |
| handoff | Local | Compact conversation into a handoff document |
| implement | Symlinked (.agents) | Implement work from specs or tickets |
| obsidian-vault | Symlinked (.agents) | Search, create, manage notes in Obsidian vault |
| prototype | Symlinked (.agents) | Build throwaway prototypes for design questions |
| tdd | Symlinked (.agents) | Test-driven development, red-green-refactor |
| teach | Symlinked (.agents) | Teach the user a new skill or concept |
| writing-great-skills | Symlinked (.agents) | Reference for writing and editing agent skills well |
| writing-guidelines | Local | Review docs for Writing Guidelines compliance |
| zim-knowledge-base | Local | Search Wikipedia ZIM files for research |
Skill Locations
| Path | Type |
|---|---|
~/.pi/agent/skills/ |
Local skills directory |
~/.agents/skills/ |
Shared skills (symlinked from) |
See Also
- pi — Pi configuration overview
- Skills documentation — the standard, CLI, and store wiring (current harness)