summaryrefslogtreecommitdiff
path: root/prompts/skills/skill-maintenance
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-07-18 22:08:10 +0300
committerPaul Buetow <paul@buetow.org>2026-07-18 22:08:10 +0300
commitefbb7876347bc667bdb3633f72a22a51b3bfbc49 (patch)
tree0a2d1d9367f4bf549584aaa71b0b82337cab2226 /prompts/skills/skill-maintenance
parentfbf9d4815ea25bd85be0f232ac8670bda1a64955 (diff)
skills: rename pkgrepo -> f3s-pkgrepo and rocky-vm-setup -> f3s-rocky-vm-setup
Extend the f3s- prefix to the two remaining f3s-scoped siblings so the whole homelab family groups together. Both are f3s-specific: pkgrepo IS pkgrepo.f3s.buetow.org, and rocky-vm-setup documents the 'rocky' VM on the f3s host f3. - git mv both skill dirs (history preserved); update name: frontmatter; add the 'Part of the f3s homelab skill family' note to both descriptions. - Rewrite every reference to the *skills*: backtick mentions (`pkgrepo` -> `f3s-pkgrepo`, `rocky-vm-setup` -> `f3s-rocky-vm-setup`), markdown cross-links (../pkgrepo/ -> ../f3s-pkgrepo/, etc.), the f3s hub Related-skills block and description, and skill-maintenance's index-pattern example. - Left references to the package REPOSITORY (pkgrepo.f3s.buetow.org, 'the custom pkgrepo') unchanged — those name a service, not the skill. - Verified all 114 relative links resolve. Plan doc updated to record the rename. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Diffstat (limited to 'prompts/skills/skill-maintenance')
-rw-r--r--prompts/skills/skill-maintenance/SKILL.md4
-rw-r--r--prompts/skills/skill-maintenance/references/sub-division.md10
2 files changed, 7 insertions, 7 deletions
diff --git a/prompts/skills/skill-maintenance/SKILL.md b/prompts/skills/skill-maintenance/SKILL.md
index faed9f3..d483e68 100644
--- a/prompts/skills/skill-maintenance/SKILL.md
+++ b/prompts/skills/skill-maintenance/SKILL.md
@@ -1,6 +1,6 @@
---
name: skill-maintenance
-description: "Maintain the ~/.agents/skills collection: audit skills against the Agent Skills spec, enforce DRY across skills (one canonical home for shared knowledge; cross-link, don't duplicate), sub-divide oversized skills into focused references/ (the f3s/rocky-vm-setup index pattern), and commit/sync changes. Use when asked to review, refactor, audit, or health-check skills, or to apply best practices to the skills collection. Triggers on: skill maintenance, audit skills, review skills, refactor skills, skill health, DRY skills, sub-divide skill, skill best practices."
+description: "Maintain the ~/.agents/skills collection: audit skills against the Agent Skills spec, enforce DRY across skills (one canonical home for shared knowledge; cross-link, don't duplicate), sub-divide oversized skills into focused references/ (the f3s/f3s-rocky-vm-setup index pattern), and commit/sync changes. Use when asked to review, refactor, audit, or health-check skills, or to apply best practices to the skills collection. Triggers on: skill maintenance, audit skills, review skills, refactor skills, skill health, DRY skills, sub-divide skill, skill best practices."
---
# Skill Maintenance
@@ -23,7 +23,7 @@ Detailed reference documentation is in the `references/` subfolder:
- [Best Practices](references/best-practices.md) — the Agent Skills spec rules + pi specifics: progressive disclosure (metadata ~100 tokens always loaded; instructions <5000 tokens / <500 lines; resources on demand), frontmatter, name rules, description, structure, scripts, references, file refs one level deep, validation.
- [DRY Across Skills](references/dry-across-skills.md) — DRY principles for a skill collection: one canonical home for shared knowledge; cross-link via `../sibling/SKILL.md`; when to share a reference vs. keep a skill self-contained; how to resolve conflicts; worked examples from this collection.
-- [Sub-division](references/sub-division.md) — when and how to sub-divide an oversized skill into focused `references/`: the index pattern (`f3s`, `rocky-vm-setup`), the "SKILL.md must not duplicate its own references" rule, naming and sizing reference files, keeping refs one level deep.
+- [Sub-division](references/sub-division.md) — when and how to sub-divide an oversized skill into focused `references/`: the index pattern (`f3s`, `f3s-rocky-vm-setup`), the "SKILL.md must not duplicate its own references" rule, naming and sizing reference files, keeping refs one level deep.
- [Audit Checklist](references/audit-checklist.md) — the concrete step-by-step checklist for reviewing a single skill or sweeping the whole collection.
## Quick Checklist
diff --git a/prompts/skills/skill-maintenance/references/sub-division.md b/prompts/skills/skill-maintenance/references/sub-division.md
index c435d3e..ae6ce97 100644
--- a/prompts/skills/skill-maintenance/references/sub-division.md
+++ b/prompts/skills/skill-maintenance/references/sub-division.md
@@ -2,7 +2,7 @@
When a skill grows too large, sub-divide it into a slim `SKILL.md` index plus
focused `references/`. The model in this collection is `f3s` and
-`rocky-vm-setup`: a short overview + a "Reference Files" list + a tiny
+`f3s-rocky-vm-setup`: a short overview + a "Reference Files" list + a tiny
quick-reference, with all detail living in `references/*.md`.
## When to sub-divide
@@ -11,7 +11,7 @@ Sub-divide when any of these hold:
- `SKILL.md` exceeds ~500 lines or ~5000 tokens (the spec's soft target).
- `SKILL.md` re-inlines content that already exists in its own `references/`
- (the worst DRY offender — `rocky-vm-setup` was this before refactoring).
+ (the worst DRY offender — `f3s-rocky-vm-setup` was this before refactoring).
- A single reference file covers multiple unrelated topics (split it).
- The agent would need to load the whole `SKILL.md` when only one section is
relevant.
@@ -24,7 +24,7 @@ Do **not** sub-divide when:
— thresholds and code are inseparable; keep inline).
- The skill is a single linear procedure with no reusable sub-topics.
-## The index pattern (f3s / rocky-vm-setup)
+## The index pattern (f3s / f3s-rocky-vm-setup)
A sub-divided `SKILL.md` should contain:
@@ -65,8 +65,8 @@ grep -l "<unique line from SKILL.md>" skill/references/*.md
- **Good index models:** `f3s`, `c-best-practices`, `bash-best-practices`,
`agent-task-management`, `llm-benchmark-comparison`, `music-collection`,
- `rocky-vm-setup` (after refactor).
-- **Sub-divided during the DRY pass:** `rocky-vm-setup` (260 → ~40 line index),
+ `f3s-rocky-vm-setup` (after refactor).
+- **Sub-divided during the DRY pass:** `f3s-rocky-vm-setup` (260 → ~40 line index),
`blog-writing-style` (216 → ~120 lines; examples moved to `references/`).
- **Borderline, kept inline by design:** `photo-processing` (snippets are the
skill's value), `check-shopping-status` (already delegates to 2 refs).