Agent skill

housekeeping

Repository housekeeping workflows for AGENTS/CLAUDE architecture, progressive disclosure, and migration of legacy monolithic instruction files.

View SKILL.md on GitHub Repository
Stars 34
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/bout3fiddy/agents/tree/main/skills/housekeeping

Metadata

Additional technical details for this skill

id
housekeeping.core
version
1
priority
65
task types 
[
    "agents-architecture",
    "migration",
    "claude-architecture",
    "repo-housekeeping",
    "housekeeping"
]
load strategy
progressive
trigger phrases 
[
    "AGENTS.md",
    "CLAUDE.md",
    "progressive disclosure",
    "legacy AGENTS migration",
    "instruction cleanup",
    "context-memory organization",
    "housekeeping"
]
activation policy
both
workflow triggers 
[
    "agents_architecture_requested",
    "legacy_migration_requested",
    "docs_housekeeping_requested"
]

SKILL.md

Housekeeping (AGENTS/CLAUDE Architecture)

Use this skill when work is about organizing or modernizing AGENTS.md/CLAUDE.md context systems.

Operating rules

  • Keep root AGENTS.md concise: critical guardrails, task router, canonical commands, and links.
  • Prefer scoped instruction files in dense areas (apps/frontend, infra, apps/agent, etc.).
  • Move deep or volatile details into .agents/repo-context/*, not root AGENTS.md.
  • Curate continuously: deduplicate, resolve contradictions, and remove stale guidance.
  • Preserve behavior intent during migrations; change structure first, then tighten wording.

Workflow

  1. Assess current state (concise router vs mixed/legacy monolith).
  2. Select target architecture from references.
  3. Migrate content into scoped AGENTS.md files and deep docs.
  4. Rewrite root AGENTS.md as a short router.
  5. Add freshness metadata for volatile facts where feasible.
  6. Verify links/routes and remove conflicting duplicate rules.
  7. If work includes both AGENTS.md and CLAUDE.md, apply parity checks in the same pass.

Canonical ownership

  • instructions/global.md: trigger registration, precedence, escalation, and lifecycle policy.
  • skills/housekeeping/SKILL.md: workflow sequence and reference selection for housekeeping execution.
  • skills/housekeeping/references/*: deep guidance and operating patterns; AGENTS and CLAUDE are references.

Reference triggers (open when clearly relevant)

  • AGENTS/CLAUDE architecture, progressive disclosure, or context-memory organization -> skills/housekeeping/references/agents-architecture.md
  • Legacy monolithic AGENTS cleanup, contradiction pruning, or migration planning -> skills/housekeeping/references/migration-playbook.md

References

  • skills/housekeeping/references/index.md - References index for this skill
  • skills/housekeeping/references/agents-architecture.md - Target architecture, file tree, and root template
  • skills/housekeeping/references/migration-playbook.md - Legacy-to-modern migration workflow and checklist

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

bout3fiddy/agents

design

Frontend design curation skill for UI critique, motion storyboarding, and DialKit tuning. Use when the user asks for interface feedback, animation sequencing, or interactive design-control setup.

34 0
Explore
bout3fiddy/agents

planning

Planning workflows for clarifying ambiguous build requests, running spec/work-package delivery, and managing Linear lifecycle transitions.

34 0
Explore
bout3fiddy/agents

coding

Core engineering skill for implementation, bug fixes, refactors, and technical reviews with mandatory smell guardrails and targeted domain reference routing.

34 0
Explore
bout3fiddy/agents

skill-creator

Create, update, or install skills (including planning/specs and edits to skills/*) using our repo workflow (uv + skills-ref validation, lean SKILL.md, references/ for detail, and sync via bin/sync.sh).

34 0
Explore
mattpocock/skills

edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

111,310 9,758
Explore
mattpocock/skills

handoff

Compact the current conversation into a handoff document for another agent to pick up.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results