chelch5/skill-deprecation-manager
01-package-scaffolding/skill-deprecation-manager/SKILL.md
Safely deprecate, retire, or merge obsolete skills while preserving backward references and library clarity. Use when a user says 'deprecate this skill', 'retire this', or 'this is replaced by X', when a catalog audit identifies a skill for retirement, or when a skill is causing harm and needs immediate pull. Do not use when the skill needs improvement (use skill-improver) or when the repo doesn't support deprecation (just delete).
development
Updated Apr 20, 2026
$ install --global
skillsauthnpx skillsauth add chelch5/skilllibrary skill-deprecation-managerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 20, 2026, 3:19 AM26.6s11 files scanned
SKILL.md
- name:
- skill-deprecation-manager
- description:
- Safely deprecate, retire, or merge obsolete skills while preserving backward references and library clarity. Use when a user says 'deprecate this skill', 'retire this', or 'this is replaced by X', when a catalog audit identifies a skill for retirement, or when a skill is causing harm and needs immediate pull. Do not use when the skill needs improvement (use skill-improver) or when the repo doesn't support deprecation (just delete).
- license:
- Apache-2.0
- clients:
- [openai-codex, gemini-cli, opencode, github-copilot]
Skill Deprecation Manager
Safely deprecates a skill: updates state, adds notices, redirects references, preserves content for history.
Procedure
1. Confirm deprecation decision
Determine the reason:
- Superseded: Replaced by a better skill
- Merged: Functionality absorbed into another skill
- Unused: No invocations over N cycles
- Failing: Consistently poor evaluation results
- Harmful: Misfiring or producing wrong outputs — pull immediately
2. Find all references
# Search across repo
grep -r "<skill-name>" AGENTS.md **/SKILL.md skills-lock.json docs/ 2>/dev/null
# Check "Do NOT use when" sections in sibling skills
grep -r "Do NOT use" **/SKILL.md | grep -i "<skill-name>"
3. Update each reference
Replace with replacement skill pointer, or note "no replacement available".
4. Update frontmatter
metadata:
maturity: deprecated
deprecated_by: replacement-skill # or "none"
deprecated_reason: "Superseded by newer version"
5. Add deprecation notice
At top of SKILL.md body:
> ⚠️ DEPRECATED as of [date]. Use [replacement] instead.
> Reason: [one sentence]. Kept for reference only.
6. Move to archive (if exists)
mkdir -p ARCHIVE
mv skill-name/ ARCHIVE/skill-name/
Do NOT delete — preserve for reference and provenance.
7. Update registry
- Mark
deprecated: trueinskills-lock.json - Remove from active catalog
- Add to "Deprecated" section of index
Output contract
## Deprecation: [skill-name]
**Reason**: [superseded | merged | unused | failing | harmful]
**Replacement**: [skill] or "none"
**Date**: [YYYY-MM-DD]
### References Updated
| File | Change |
|------|--------|
| [file] | [old → new] |
### Verification
- [x] All references updated
- [x] Deprecation notice added
- [x] Archived
- [x] Registry updated
Failure handling
- Active dependencies, no replacement: Don't deprecate — document gap, build replacement first
- Replacement incomplete: Create migration path with limitations noted
- Urgent harm: Deprecate immediately, create follow-up ticket for replacement
Related Skills
chelch5/context-intelligence
testing
VerifiedTrustedCommunity
Manages context window budgets, loading strategies, and compaction techniques for AI-assisted coding sessions. Trigger on 'context window', 'what to load', 'context management', 'context overflow', 'token budget'. DO NOT USE for loading specific project docs into agent context (use project-context) or prompt wording and optimization (use prompt-crafting).
SKILL.mdUpdated Apr 20, 2026
chelch5/auth-patterns
development
VerifiedTrustedCommunity
Implements authentication, session, token, and authorization patterns for the current stack. Trigger on 'add auth', 'JWT', 'OAuth', 'login endpoint', 'session management', 'API key auth'. DO NOT USE for OWASP hardening checklists (use security-hardening), threat modeling (use security-threat-model), or secret rotation/storage (use security-best-practices).
SKILL.mdUpdated Apr 20, 2026
chelch5/api-schema
tools
VerifiedTrustedCommunity
Defines request/response shapes, versioning, validation, and compatibility rules for API-first work. Trigger on 'design API', 'OpenAPI spec', 'REST schema', 'API versioning', 'generate client SDK'. DO NOT USE for GraphQL schemas, gRPC/protobuf definitions (use stack-standards), auth endpoint logic (use auth-patterns), or external API client wrappers (use external-api-client).
SKILL.mdUpdated Apr 20, 2026
chelch5/ticket-pack-builder
development
VerifiedTrustedCommunity
Create a repo-local ticket system with an index, machine-readable manifest, board, and individual ticket files. Use when a repo needs task decomposition that autonomous agents can follow without re-planning the whole project each session. Do not use for executing tickets (use ticket-execution) or quick fixes that don't warrant formal tickets.
SKILL.mdUpdated Apr 20, 2026