Skip to content

Commit e4a7b5e

Browse files
committed
Update Pi skill tooling dotfiles
1 parent 952b3ee commit e4a7b5e

6 files changed

Lines changed: 404 additions & 74 deletions

File tree

config/pi/agent/extensions/pi-skill-audit/README.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# pi-skill-audit
22

3-
Deterministic, read-only skill auditor for Pi.
3+
Deterministic, read-only skill auditor for Pi, plus safe LLM-assisted skill improvement proposals.
44

55
## Commands
66

@@ -10,6 +10,7 @@ Deterministic, read-only skill auditor for Pi.
1010
/skill-audit project audit project skill dirs
1111
/skill-audit <query> audit skills whose name/path contains query
1212
/skill-improve <query> generate a Gemini Flash improvement proposal for one skill
13+
/skill-manager open an interactive menu to pick a skill and run actions
1314
```
1415

1516
## Tool
@@ -28,6 +29,8 @@ Writes:
2829
.pi/skill-audit/improve-<skill>.md
2930
```
3031

32+
`improve-<skill>.md` includes review scores, main gaps, proposed changes, a suggested patch, lightweight eval scenarios, and approval questions. For symlinked skills it records both the display path and resolved source path.
33+
3134
## Scope
3235

3336
Scans the standard Pi skill locations:
@@ -55,4 +58,6 @@ Scans the standard Pi skill locations:
5558

5659
`/skill-audit` does not use an LLM and never edits skills.
5760

58-
`/skill-improve` uses `google/gemini-2.5-flash` through Pi's model registry to generate a proposal/diff only. It never edits skills. Review the proposal and explicitly ask Pi to apply changes if you approve.
61+
`/skill-improve` prefers `google/gemini-3-flash-preview`, falls back to `google/gemini-2.5-flash`, then the current model. It uses a fixed rubric inspired by skill optimization workflows: completeness, actionability, conciseness, robustness, invocation clarity, safety/approval, and validation. It generates a proposal/diff only and never edits skills. Review the proposal and explicitly ask Pi to apply changes if you approve.
62+
63+
`/skill-manager` opens quickly by listing discovered skills without auditing them all. The skill picker uses a scrollable TUI list with compact labels, prefix filtering by typing, symlink badges, duplicate-count badges, and paths in descriptions. Pick a skill, then choose `Run audit`, `Generate improve proposal`, `Open latest proposal in nvim`, or `Show paths`. `Run audit` keeps the persistent widget compact and points to `/skill-audit <name>` for full details. After generating an improve proposal, the UI asks whether to open the proposal in Neovim. Symlinked skill directories are followed during discovery; path views and improve reports show the resolved source path to make future approved edits target the source.

0 commit comments

Comments
 (0)