# Maintain Project Skills

> Maintains thin callers for the reusable project Agent Skills update workflow, migrates deleted or renamed skills from source evidence, and diagnoses update failures without taking ownership away from generated files. Use when adding or upgrading project-scoped skills automation or repairing its inventory.

- Skill: `frostney/maintain-project-skills` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add frostney/maintain-project-skills`
- Raw SKILL.md: https://api.skillmd.com/api/skills/frostney/maintain-project-skills/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: Unlicense OR MIT
- Author: frostney (https://skillmd.com/u/frostney)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/frostney/maintain-project-skills

---


# Maintain project Agent Skills

Keep project Agent Skills reproducible without turning generated payloads into
hand-authored files. This playbook maintains callers and exceptional migrations;
the reusable workflow owns scheduled refresh mechanics.

Before changing a caller, migrating inventory, or diagnosing a failure, read
[the portable project-skills maintenance runbook](references/project-skills-runbook.md).
It contains the exact caller permissions, immutable-pinning rules, migration
evidence requirements, and failure branches. The reference ships inside this
skill directory so a project-scoped installation remains self-contained.

Do not copy the scheduled runtime into a consumer, install KGR globally, edit
CLI-generated payloads or hashes by hand, or merge an automation PR. Use the
consumer's validated project root and pinned skills CLI for every inventory
mutation.

## Completion

- The caller remains thin and pins an immutable reusable-workflow revision.
- `.agents/skills` and `skills-lock.json` changed only through the pinned skills
  CLI or the workflow's opt-in deterministic hash normalization.
- Inventory membership changes have source evidence and were reviewed as a
  migration.
- The caller's workflow validation passes, and any resulting PR remains draft
  for normal project review; nothing was merged automatically.