| name | project-cleanup |
| description | Generic project hygiene skill. Triggers on "clean up the project",
"tidy the repo", "remove leftovers", "absorb fragments", "merge small
docs", "check project state", "verify structure", "audit tasks / backlog
/ changelog", or any request to detect + remove orphan files,
consolidate small markdown fragments into unified docs, and report
project-state health. Auto-detects project structure (cyberos task
catalog if present; falls back to generic repo cleanup otherwise).
|
| skill_version | 1.0.1 |
| persona | shared |
| owner_role | _shared |
| allowed_memory_scopes | {"read":[],"write":[]} |
| allowed_mcp_tools | ["file_read","file_write","bash","file_delete"] |
| escalation | {"to_persona_on_legal":null,"to_persona_on_security":null,"to_persona_on_compliance":null,"to_human_on_irreversible":true} |
| expects | {"schema_ref":"./envelopes/input.json","required_fields":["project_root"],"optional_fields":["scope","dry_run","absorb_threshold_lines"]} |
| produces | {"schema_ref":"./envelopes/output.json","output_kind":"report"} |
| audit | {"emit_to":"memory.action_log","row_kind":"cleanup_report","payload_hash_field":"report_sha256","explanation_pane":"required"} |
| confidence_band | {"default":0.85,"defer_below":0.7,"cite_sources":"required"} |
| untrusted_inputs | {"wrap_in_marker":"untrusted_content","injection_scan":"required","on_marker_hit":"surface_to_human"} |
| determinism | {"reproducible":false,"fixity_notes":"Project state varies between runs (new files, new commits). Each invocation produces a fresh inventory + report."} |
| emitted_source_freshness_tier | 90 |
| gated_until_phase | null |
project-cleanup — repo hygiene + state audit
A generic project-cleanup skill. Run it when the repo accumulates fragment files, orphan docs, audit-trail debt, or you want a single command that says "is the project still in good shape?"
What it does
Four phases, executed in order:
- Inventory — scan the project for stale fragments, orphan files, structural drift.
- Absorb + merge — consolidate small markdown fragments (<N lines) into the most-suitable parent doc.
- Delete leftovers — remove anything safely flagged as trash + confirm with the operator before destructive action.
- Verify state — run project-aware checks (cyberos task DAG coherence, audit-score grep, BACKLOG/CHANGELOG sync) or generic checks (broken links, orphan refs).
When to use
Trigger this skill when you say any of:
- "Clean up the project"
- "Tidy the repo"
- "Remove leftovers / fragments / orphan files"
- "Absorb / merge small docs"
- "Check project state"
- "Verify project structure"
- "Audit tasks / backlog / changelog"
- "Health check the repo"
Behaviour (what the skill does)
Phase 1 — Inventory (read-only, never destructive)
The skill MUST first build an inventory before touching anything. The inventory is a structured map of:
- Top-level layout — directories + file counts per dir.
- Suspicious leftovers — markdown files matching patterns:
*_SUMMARY.md, *_PROGRESS.md, *_NOTES.md outside an explicit notes/ folder*.md.bak, *.old.md, tmp_*.md, draft_*.md- Files in known-archive paths (
archive/, _old/, deprecated/)
- Orphan audit pairs — for repos with audit discipline: spec files missing audits, audit files missing specs
- Stale references — broken cross-doc links (file deleted but linked from elsewhere)
- Small fragments — markdown files under
absorb_threshold_lines (default: 80) that could merge into a parent
The inventory is reported back as a structured Markdown table BEFORE any mutation. The operator approves what to act on.
