diff options
| author | Paul Buetow <paul@buetow.org> | 2026-07-18 22:08:10 +0300 |
|---|---|---|
| committer | Paul Buetow <paul@buetow.org> | 2026-07-18 22:08:10 +0300 |
| commit | efbb7876347bc667bdb3633f72a22a51b3bfbc49 (patch) | |
| tree | 0a2d1d9367f4bf549584aaa71b0b82337cab2226 /prompts/skills/skill-maintenance | |
| parent | fbf9d4815ea25bd85be0f232ac8670bda1a64955 (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.md | 4 | ||||
| -rw-r--r-- | prompts/skills/skill-maintenance/references/sub-division.md | 10 |
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). |
