ReddRadar
Agent skill
deprecation-manager
Manage API and SDK deprecation lifecycle
Install this agent skill to your Project
npx add-skill https://github.com/a5c-ai/babysitter/tree/main/library/specializations/sdk-platform-development/skills/deprecation-manager
SKILL.md
Deprecation Manager Skill
Overview
This skill manages the complete deprecation lifecycle for APIs and SDKs, from initial deprecation notices through sunset, ensuring smooth transitions for API consumers.
Capabilities
- Track deprecation timelines and milestones
- Inject deprecation warnings in SDK code
- Send sunset notifications to API consumers
- Generate migration documentation automatically
- Monitor deprecated endpoint usage
- Configure Sunset and Deprecation HTTP headers
- Implement gradual deprecation with usage thresholds
- Archive deprecated documentation appropriately
Target Processes
- Backward Compatibility Management
- API Versioning Strategy
- SDK Versioning and Release Management
Integration Points
- Sunset header injection middleware
- Deprecation annotation processors
- Usage analytics systems
- Email/notification services
- Documentation platforms
Input Requirements
- Deprecation policy and timelines
- Affected endpoints/features list
- Replacement/migration paths
- Consumer notification requirements
- Usage monitoring access
Output Artifacts
- Deprecation timeline documentation
- SDK deprecation annotations
- Migration guides
- Sunset header configurations
- Consumer notification templates
- Usage monitoring dashboards
- Archived documentation
Usage Example
skill:
name: deprecation-manager
context:
deprecationPolicy: ./docs/deprecation-policy.md
features:
- featureId: legacy-auth
deprecationDate: "2024-06-01"
sunsetDate: "2024-12-01"
replacement: oauth2-flow
notificationChannels:
- email
- dashboard
- sdkWarnings
usageThreshold: 100
Best Practices
- Announce deprecations well in advance (6+ months)
- Provide clear migration paths with examples
- Monitor usage before sunset
- Send multiple reminder notifications
- Keep deprecated docs available but marked
- Implement gradual rate limiting before full sunset
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
a5c-ai/babysitter
gsd-tools
Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).
a5c-ai/babysitter
model-profile-resolution
Resolve model profile (quality/balanced/budget) at orchestration start and map agents to specific models. Enables cost/quality tradeoffs by selecting appropriate AI models for each agent role.
a5c-ai/babysitter
verification-suite
Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete.
a5c-ai/babysitter
state-management
STATE.md reading, writing, and field-level updates. Provides cross-session state persistence via .planning/STATE.md with structured fields for current task, completed phases, blockers, decisions, and quick tasks.
a5c-ai/babysitter
git-integration
Git commit patterns, formats, and conventions for GSD methodology. Provides atomic commits per task, structured commit messages, planning file commits, branch management, and milestone tag operations.
a5c-ai/babysitter
frontmatter-parsing
YAML frontmatter parsing and manipulation for .planning/ documents. Provides read, write, update, query, and validation operations on frontmatter blocks in GSD markdown artifacts.
Didn't find tool you were looking for?