{"slug":"addyosmani-deprecation-and-migration","name":"deprecation-and-migration","description":"Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.","long_description":"---\nname: deprecation-and-migration\ndescription: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.\n---\n\n# Deprecation and Migration\n\n## Overview\n\nCode is a liability, not an asset. Every line of code has ongoing maintenance cost — bugs to fix, dependencies to update, security patches to apply, and new engineers to onboard. Deprecation is the discipline of removing code that no longer earns its keep, and migration is the process of moving users safely from the old to the new.\n\nMost engineering organizations are good at building things. Few are good at removing them. This skill addresses that gap.\n\n## When to Use\n\n- Replacing an old system, API, or library with a new one\n- Sunsetting a feature that's no longer needed\n- Consolidating duplicate implementations\n- Removing dead code that nobody owns but everybody depends on\n- Planning the lifecycle of a new system (deprecation planning starts at design time)\n- Deciding whether to maintain a legacy system or invest in migration\n\n## Core Principles\n\n### Code Is a Liability\n\nEvery line of code has ongoing cost: it needs tests, documentation, security patches, dependency updates, and mental overhead for anyone working nearby. The value of code is the functionality it provides, not the code itself. When the same functionality can be provided with less code, less complexity, or better abstractions — the old code should go.\n\n### Hyrum's Law Makes Removal Hard\n\nWith enough users, every observable behavior becomes depended on — including bugs, timing quirks, and undocumented side effects. This is why deprecation requires active migration, not just announcement. Users can't \"just switch\" when they depend on behaviors the replacement doesn't replicate.\n\n### Deprecation Planning Starts at Design Time\n\nWhen building something new, ask: \"How would we remove this in 3 years?\" Systems designed with clean interfaces, feature flags, and minimal surface area are easier to deprecate than systems that leak implementation details everywhere.\n\n## The Deprecation Decision\n\nBefore deprecating anything, answer these questions:\n\n```\n1. Does this system still provide unique value?\n   → If yes, maintain it. If no, proceed.\n\n2. How many users/consumers depend on it?\n   → Quantify the migration scope.\n\n3. Does a replacement exist?\n   → If no, build the replacement first. Don't deprecate without an alternative.\n\n4. What's the migration cost for each consumer?\n   → If trivially automated, do it. If manual and high-effort, weigh against maintenance cost.\n\n5. What's the ongoing maintenance cost of NOT deprecating?\n   → Security risk, engineer time, opportunity cost of complexity.\n```\n\n## Compulsory vs Advisory Deprecation\n\n| Type | When to Use | Mechanism |\n|------|-------------|-----------|\n| **Advisory** | Migration is optional, old system is stable | Warnings, documentation, nudges. Users migrate on their own timeline. |\n| **Compulsory** | Old system has security issues, blocks progress, or maintenance cost is unsustainable | Hard deadline. Old system will be removed by date X. Provide migration tooling. |\n\n**Default to advisory.** Use compulsory only when the maintenance cost or risk justifies forcing migration. Compulsory deprecation requires providing migration tooling, documentation, and support — you can't just announce a deadline.\n\n## The Migration Process\n\n### Step 1: Build the Replacement\n\nDon't deprecate without a working alternative. The replacement must:\n\n- Cover all critical use cases of the old system\n- Have documentation and migration guides\n- Be proven in production (not just \"theoretically better\")\n\n### Step 2: Announce and Document\n\n```markdown\n## Deprecation Notice: OldService\n\n**Status:** Deprecated as of 2025-03-01\n**Replacement:** NewService (see migration guide below)\n**Removal date:** Advisory — no hard deadline yet\n**Reason:** OldService requires manual scaling and lacks observability.\n            NewService handles both automatically.\n\n### Migration Guide\n1. Replace `import { client } from 'old-service'` with `import { client } from 'new-service'`\n2. Update configuration (see examples below)\n3. Run the migration verification script: `npx migrate-check`\n```\n\n### Step 3: Migrate Incrementally\n\nMigrate consumers one at a time, not all at once. For each consumer:\n\n```\n1. Identify all touchpoints with the deprecated system\n2. Update to use the replacement\n3. Verify behavior matches (tests, integration checks)\n4. Remove references to the old system\n5. Confirm no regressions\n```\n\n**The Churn Rule:** If you own the infrastructure being deprecated, you are responsible for migrating your users — or providing backward-compatible updates that require no migration. Don't announce deprecation and leave users to figure it out.\n\n### Step 4: Remove the Old System\n\nOnly after all consumers have migrated:\n\n```\n1. Verify zero active usage (metrics, logs, dependency analysis)\n2. Remove the code\n3. Remove associated tests, documentation, and configuration\n4. Remove the deprecation notices\n5. Celebrate — removing code is an achievement\n```\n\n## Migration Patterns\n\n### Strangler Pattern\n\nRun old and new systems in parallel. Route traffic incrementally from old to new. When the old system handles 0% of traffic, remove it.\n\n```\nPhase 1: New system handles 0%, old handles 100%\nPhase 2: New system handles 10% (canary)\nPhase 3: New system handles 50%\nPhase 4: New system handles 100%, old system idle\nPhase 5: Remove old system\n```\n\n### Adapter Pattern\n\nCreate an adapter that translates calls from the old interface to the new implementation. Consumers keep using the old interface while you migrate the backend.\n\n```typescript\n// Adapter: old interface, new implementation\nclass LegacyTaskService implements OldTaskAPI {\n  constructor(private newService: NewTaskService) {}\n\n  // Old method signature, delegates to new implementation\n  getTask(id: number): OldTask {\n    const task = this.newService.findById(String(id));\n    return this.toOldFormat(task);\n  }\n}\n```\n\n### Feature Flag Migration\n\nUse feature flags to switch consumers from old to new system one at a time:\n\n```typescript\nfunction getTaskService(userId: string): TaskService {\n  if (featureFlags.isEnabled('new-task-service', { userId })) {\n    return new NewTaskService();\n  }\n  return new LegacyTaskService();\n}\n```\n\n### Database Schema Migrations (Expand/Contract)\n\nA schema change is the riskiest migration because the data is the one thing you cannot roll back by reverting a deploy. The failure mode is coupling the schema change to the code change: rename a column in the same release that starts using the new name, and during the rollout window — when old and new code run at once — one of them is querying a column that doesn't exist. The fix is to **never change a column in place**. Migrate in additive phases so old and new code are both valid at every step.\n\n```\nEXPAND ──────────────→ MIGRATE ──────────────→ CONTRACT\nadd the new column,    backfill existing rows,  once no code reads the\nnullable, alongside    dual-write old+new from  old column, drop it in\nthe old one            the app                  a later, separate deploy\n```\n\n**Worked example — renaming `name` to `full_name`:**\n\n1. **Expand.** Add `full_name` as nullable. Deploy. (Old code ignores it; nothing breaks.)\n2. **Dual-write.** App writes both `name` and `full_name` on every insert/update. Deploy.\n3. **Backfill.** Copy `name → full_name` for existing rows, in batches, so you don't lock the table.\n4. **Switch reads.** Point the app at `full_name`, keep writing both. Deploy and bake.\n5. **Contract.** Stop writing `name`, then — in a *separate, later* deploy — drop the column.\n\nEach step is independently deployable and reversible: if step 4 misbehaves, roll the code back and `full_name` is still being populated. Treat each phase as a thin vertical slice — see the `incremental-implementation` skill.\n\n**Rules:**\n- **Additive first, destructive last and alone.** Adds (new nullable column, new table, new index) are safe in any deploy; drops and renames get their own deploy *after* no code references the old shape.\n- **Every migration has a tested down path.** A migration you can't reverse is a deploy you can't roll back. Write and run the `down` before merging.\n- **Backfill in batches, off the hot path.** A single `UPDATE` over millions of rows locks the table; chunk it and throttle.\n- **Build large indexes without blocking writes** (e.g. Postgres `CREATE INDEX CONCURRENTLY`).\n- **Decouple from code by feature flag** when the cutover is risky, exactly as in the Feature Flag Migration pattern above.\n\n## Zombie Code\n\nZombie code is code that nobody owns but everybody depends on. It's not actively maintained, has no clear owner, and accumulates security vulnerabilities and compatibility issues. Signs:\n\n- No commits in 6+ months but active consumers exist\n- No assigned maintainer or team\n- Failing tests that nobody fixes\n- Dependencies with known vulnerabilities that nobody updates\n- Documentation that references systems that no longer exist\n\n**Response:** Either assign an owner and maintain it properly, or deprecate it with a concrete migration plan. Zombie code cannot stay in limbo — it either gets investment or removal.\n\n## Common Rationalizations\n\n| Rationalization | Reality |\n|---|---|\n| \"It still works, why remove it?\" | Working code that nobody maintains accumulates security debt and complexity. Maintenance cost grows silently. |\n| \"Someone might need it later\" | If it's needed later, it can be rebuilt. Keeping unused code \"just in case\" costs more than rebuilding. |\n| \"The migration is too expensive\" | Compare migration cost to ongoing maintenance cost over 2-3 years. Migration is usually cheaper long-term. |\n| \"We'll deprecate it after we finish the new system\" | Deprecation planning starts at design time. By the time the new system is done, you'll have new priorities. Plan now. |\n| \"Users will migrate on their own\" | They won't. Provide tooling, documentation, and incentives — or do the migration yourself (the Churn Rule). |\n| \"We can maintain both systems indefinitely\" | Two systems doing the same thing is double the maintenance, testing, documentation, and onboarding cost. |\n| \"Just rename the column, it's one line\" | During the rollout, old and new code run together — one will query a column that no longer exists. Expand/contract, never rename in place. |\n| \"I'll add the column and drop the old one in the same migration\" | That couples a safe add to a destructive drop. Drops get their own deploy, after no code references the old shape. |\n| \"We'll write the rollback if we need it\" | A migration with no down path is a deploy you can't reverse. Write and run the `down` before merging. |\n\n## Red Flags\n\n- Deprecated systems with no replacement available\n- Deprecation announcements with no migration tooling or documentation\n- \"Soft\" deprecation that's been advisory for years with no progress\n- Zombie code with no owner and active consumers\n- New features added to a deprecated system (invest in the replacement instead)\n- Deprecation without measuring current usage\n- Removing code without verifying zero active consumers\n- A schema change and the code that depends on it shipped in the same deploy\n- A column renamed or dropped in place rather than via expand/contract\n- A migration merged with no tested down path, or a backfill that locks the table\n\n## Verification\n\nAfter completing a deprecation:\n\n- [ ] Replacement is production-proven and covers all critical use cases\n- [ ] Migration guide exists with concrete steps and examples\n- [ ] All active consumers have been migrated (verified by metrics/logs)\n- [ ] Old code, tests, documentation, and configuration are fully removed\n- [ ] No references to the deprecated system remain in the codebase\n- [ ] Deprecation notices are removed (they served their","tagline":"Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.","category":"coding-agents","tags":["agent-skill"],"author":"addyosmani","verified":false,"attribution":{"status":"registry_indexed","statusLabel":"Registry indexed","shortLabel":"REGISTRY INDEXED","sourceLabel":"github fast track","sourceDetail":"addyosmani/agent-skills","creatorName":"addyosmani","creatorUrl":"https://github.com/addyosmani","sourceUrl":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration","indexedBy":"OpenAgentSkill community index","claimUrl":"https://www.openagentskill.com/skills/addyosmani-deprecation-and-migration#claim-this-skill","claimCta":"Claim this skill","trustNote":"This listing was indexed from public sources and is not marked official until a maintainer claim is approved.","publicNote":"Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals."},"stats":{"stars":91373,"forks":9758,"verified_installs":0,"successful_runs":0,"total_outcomes":0,"rating":0,"review_count":0,"quality_score":57.83},"quality":{"score":95,"tier":"excellent","label":"Excellent","summary":"High-confidence pick with strong adoption and healthy maintenance signals.","signals":[{"label":"GitHub stars","value":"91K","tone":"positive"},{"label":"Freshness","value":"8d ago","tone":"positive"},{"label":"Install ready","value":"Yes","tone":"positive"},{"label":"License","value":"MIT","tone":"neutral"}],"warnings":[]},"trust":{"version":"trust-score-v5","score":77,"base_score":85,"outcome_confidence":0,"tier":"strong","label":"Review then install","summary":"Good shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.","recommendedAction":"Use as the primary candidate after human or sandbox review.","decision":{"install_policy":"human_review_before_install","auto_install_allowed":false,"human_review_required":true,"sandbox_first":true,"agent_action":"Ask for approval or run a sandbox-only trial before installing.","reasoning":["77/100 Trust Score v5","85/100 Trust Score v4 baseline","Needs more real agent outcomes before unattended install","Install path is available","Review before production"],"review_required_when":["The workspace contains production secrets, payments, private customer data, or irreversible actions.","The install command requests shell, network, credential, database, or broad filesystem access.","Outcome evidence is missing, recently failed, or required human review.","Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"]},"dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":100,"weight":0.13,"status":"pass","detail":"91K GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":100,"weight":0.08,"status":"pass","detail":"91K stars, 9.8K forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"8d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":86,"weight":0.14,"status":"pass","detail":"Metadata includes enough usage and workflow context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":74,"weight":0.12,"status":"info","detail":"network or browser surface, database surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":60,"weight":0.07,"status":"warn","detail":"filesystem or document access, network or browser access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration"},{"id":"review_status","label":"Review status","score":88,"weight":0.05,"status":"pass","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"pass","label":"GitHub adoption","detail":"91K GitHub stars"},{"status":"pass","label":"Stars/forks activity","detail":"91K stars, 9.8K forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"8d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"pass","label":"README/SKILL.md completeness","detail":"Metadata includes enough usage and workflow context"},{"status":"info","label":"Dependency/runtime risk","detail":"network or browser surface, database surface"},{"status":"pass","label":"Install availability","detail":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"warn","label":"Permission surface","detail":"filesystem or document access, network or browser access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration"},{"status":"pass","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"info","label":"OpenAgentSkill usage","detail":"No local usage activity yet"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Large GitHub adoption signal","Install command has no obvious high-risk pattern","Outcome loop is ready but needs first real agent run"],"warnings":["Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access","No real agent outcome reports yet","Human review required before unattended installation"],"evidence":{"stars":"91K GitHub stars","repoActivity":"91K stars, 9.8K forks","lastPushed":"8d since push","license":"MIT","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration","install":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet","agentProvenScore":0,"outcomeConfidence":"0%","installPolicy":"human_review_before_install"},"installReadiness":{"ready":true,"command":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","8d since push","Financial domain: human review is required before use in a live investment workflow.","Trust Score v5 requires review or sandbox-only use before install."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Ask for approval or run a sandbox-only trial before installing."},"outcome_loop":{"version":"openagentskill-agent-outcome-v4","required_after_install":true,"endpoint":"/api/agent/outcome","method":"POST","event_id_source":"feedback.event_id, install_receipt.resolve_event_id, or decision_packet.outcome_feedback.event_id","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"required_fields":["event_id","skill_slug","task"],"quality_fields":["task_success","output_quality","error_type","human_review_required","used_in_production","workspace","evidence_url","time_to_useful_ms","source_version"],"ranking_inputs_updated":["Trust Score v5 outcome confidence","Agent Proven Score","Resolve ranking task-fit evidence","Skill detail machine-readable metadata","Outcome leaderboard"]},"agent_contract":{"suited_tasks":["coding-agents","agent-skill"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"install_command":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","trust_score":77,"trust_version":"trust-score-v5","risk_level":"medium","do_not_use_when":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Autonomous investment, trading, tax, or suitability decisions without a qualified human review"],"before_install":["Read the audit page and machine-readable metadata.","Confirm the install command, license, and permission surface fit the workspace.","Get explicit human approval or choose an alternative before installing."],"after_run":["Report the outcome to /api/agent/outcome using the resolve event id.","Include output_quality, workspace, human_review_required, and evidence_url when available.","Re-resolve before broad production rollout."]},"bestFor":["coding-agents","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Autonomous investment, trading, tax, or suitability decisions without a qualified human review"],"knownRisks":["Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"],"backward_compatible":{"trust_score_v4":{"version":"trust-score-v4","score":85,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout."}}},"trust_score_v5":{"version":"trust-score-v5","score":77,"base_score":85,"outcome_confidence":0,"tier":"strong","label":"Review then install","summary":"Good shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.","recommendedAction":"Use as the primary candidate after human or sandbox review.","decision":{"install_policy":"human_review_before_install","auto_install_allowed":false,"human_review_required":true,"sandbox_first":true,"agent_action":"Ask for approval or run a sandbox-only trial before installing.","reasoning":["77/100 Trust Score v5","85/100 Trust Score v4 baseline","Needs more real agent outcomes before unattended install","Install path is available","Review before production"],"review_required_when":["The workspace contains production secrets, payments, private customer data, or irreversible actions.","The install command requests shell, network, credential, database, or broad filesystem access.","Outcome evidence is missing, recently failed, or required human review.","Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"]},"dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":100,"weight":0.13,"status":"pass","detail":"91K GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":100,"weight":0.08,"status":"pass","detail":"91K stars, 9.8K forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"8d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":86,"weight":0.14,"status":"pass","detail":"Metadata includes enough usage and workflow context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":74,"weight":0.12,"status":"info","detail":"network or browser surface, database surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":60,"weight":0.07,"status":"warn","detail":"filesystem or document access, network or browser access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration"},{"id":"review_status","label":"Review status","score":88,"weight":0.05,"status":"pass","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"pass","label":"GitHub adoption","detail":"91K GitHub stars"},{"status":"pass","label":"Stars/forks activity","detail":"91K stars, 9.8K forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"8d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"pass","label":"README/SKILL.md completeness","detail":"Metadata includes enough usage and workflow context"},{"status":"info","label":"Dependency/runtime risk","detail":"network or browser surface, database surface"},{"status":"pass","label":"Install availability","detail":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"warn","label":"Permission surface","detail":"filesystem or document access, network or browser access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration"},{"status":"pass","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"info","label":"OpenAgentSkill usage","detail":"No local usage activity yet"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Large GitHub adoption signal","Install command has no obvious high-risk pattern","Outcome loop is ready but needs first real agent run"],"warnings":["Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access","No real agent outcome reports yet","Human review required before unattended installation"],"evidence":{"stars":"91K GitHub stars","repoActivity":"91K stars, 9.8K forks","lastPushed":"8d since push","license":"MIT","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration","install":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet","agentProvenScore":0,"outcomeConfidence":"0%","installPolicy":"human_review_before_install"},"installReadiness":{"ready":true,"command":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","8d since push","Financial domain: human review is required before use in a live investment workflow.","Trust Score v5 requires review or sandbox-only use before install."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Ask for approval or run a sandbox-only trial before installing."},"outcome_loop":{"version":"openagentskill-agent-outcome-v4","required_after_install":true,"endpoint":"/api/agent/outcome","method":"POST","event_id_source":"feedback.event_id, install_receipt.resolve_event_id, or decision_packet.outcome_feedback.event_id","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"required_fields":["event_id","skill_slug","task"],"quality_fields":["task_success","output_quality","error_type","human_review_required","used_in_production","workspace","evidence_url","time_to_useful_ms","source_version"],"ranking_inputs_updated":["Trust Score v5 outcome confidence","Agent Proven Score","Resolve ranking task-fit evidence","Skill detail machine-readable metadata","Outcome leaderboard"]},"agent_contract":{"suited_tasks":["coding-agents","agent-skill"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"install_command":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","trust_score":77,"trust_version":"trust-score-v5","risk_level":"medium","do_not_use_when":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Autonomous investment, trading, tax, or suitability decisions without a qualified human review"],"before_install":["Read the audit page and machine-readable metadata.","Confirm the install command, license, and permission surface fit the workspace.","Get explicit human approval or choose an alternative before installing."],"after_run":["Report the outcome to /api/agent/outcome using the resolve event id.","Include output_quality, workspace, human_review_required, and evidence_url when available.","Re-resolve before broad production rollout."]},"bestFor":["coding-agents","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Autonomous investment, trading, tax, or suitability decisions without a qualified human review"],"knownRisks":["Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"],"backward_compatible":{"trust_score_v4":{"version":"trust-score-v4","score":85,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout."}}},"trust_score_v4":{"version":"trust-score-v4","score":85,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout.","recommendedAction":"Test in a sandbox workflow and compare its install path with close alternatives.","dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":100,"weight":0.13,"status":"pass","detail":"91K GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":100,"weight":0.08,"status":"pass","detail":"91K stars, 9.8K forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"8d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":86,"weight":0.14,"status":"pass","detail":"Metadata includes enough usage and workflow context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":74,"weight":0.12,"status":"info","detail":"network or browser surface, database surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":60,"weight":0.07,"status":"warn","detail":"filesystem or document access, network or browser access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration"},{"id":"review_status","label":"Review status","score":88,"weight":0.05,"status":"pass","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"pass","label":"GitHub adoption","detail":"91K GitHub stars"},{"status":"pass","label":"Stars/forks activity","detail":"91K stars, 9.8K forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"8d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"pass","label":"README/SKILL.md completeness","detail":"Metadata includes enough usage and workflow context"},{"status":"info","label":"Dependency/runtime risk","detail":"network or browser surface, database surface"},{"status":"pass","label":"Install availability","detail":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"warn","label":"Permission surface","detail":"filesystem or document access, network or browser access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration"},{"status":"pass","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"info","label":"OpenAgentSkill usage","detail":"No local usage activity yet"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Large GitHub adoption signal","Install command has no obvious high-risk pattern"],"warnings":["Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"],"evidence":{"stars":"91K GitHub stars","repoActivity":"91K stars, 9.8K forks","lastPushed":"8d since push","license":"MIT","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration","install":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet"},"installReadiness":{"ready":true,"command":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","8d since push","Financial domain: human review is required before use in a live investment workflow."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Human review or sandbox validation is required before automatic installation."},"bestFor":["coding-agents","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Autonomous investment, trading, tax, or suitability decisions without a qualified human review"],"knownRisks":["Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"outcome_stats":null,"safety":{"score":70,"level":"review_before_install","label":"Review before install","safety_tier":{"tier":"reviewed","label":"Reviewed with permission notes","badge":"REVIEWED","summary":"Usable candidate, but the agent should surface permission and audit notes before installation.","recommended_action":"Require human approval before installing into a real workspace.","auto_install_policy":"review","reasons":["Permission surface may require sandboxing","70/100 agent safety score"]},"auto_install_allowed":false,"human_review_required":true,"blocked":false,"audit_risk":"needs_review","permission_hints":[{"id":"network","label":"Network access","reason":"Skill likely fetches remote pages, APIs, repositories, or external services.","severity":"medium"},{"id":"filesystem","label":"Filesystem access","reason":"Skill may read or write project files, documents, generated artifacts, or local workspace state.","severity":"medium"},{"id":"database","label":"Database access","reason":"Skill may inspect schemas, query databases, or work with persistent stores.","severity":"medium"}],"policy_warnings":["Permission surface may require sandboxing"],"constraints_applied":{"max_risk":"medium","needs_install_command":true,"min_stars":0}},"safety_gate":{"tier":"reviewed","label":"Reviewed with permission notes","badge":"REVIEWED","auto_install_policy":"review","auto_install_allowed":false,"blocked":false,"human_review_required":true,"recommended_action":"Require human approval before installing into a real workspace.","reasons":["Permission surface may require sandboxing","70/100 agent safety score"]},"eval":{"version":"openagentskill-skill-eval-v1","status":"review","score":85,"risk_level":"medium","decision":{"recommendation":"manual_review","reason":"Require human approval before installing into a real workspace.","auto_install_allowed":false,"policy":"review","human_review_required":true},"blockers":[],"warnings":["Audit score: Needs review","Agent safety gate: Usable candidate, but the agent should surface permission and audit notes before installation.","Permission surface: filesystem or document access, network or browser access","Permission surface may require sandboxing","Financial research output is not financial advice; require human review before any live investment decision","Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access"],"validation_plan":["Inspect repository, README/SKILL.md, license, and recent commits before production use.","Install in an isolated workspace or sandbox with no production secrets available.","Run the smallest representative task and record files touched, commands run, network access, and outputs.","Compare the selected skill against at least one alternative when the eval status is review or failed.","Promote only after the agent reports a successful verification result and unresolved warnings are accepted."],"checks":[{"id":"task_fit","label":"Task fit","status":"pass","score":84,"required_for_auto_install":true,"detail":"Task wording matches this skill metadata.","evidence":["Evaluate deprecation-and-migration before installing it in an agent workflow","coding-agents","Database and SQL workflows; Claude Code teams; teams that value GitHub adoption signals"]},{"id":"install_path","label":"Install path","status":"pass","score":92,"required_for_auto_install":true,"detail":"Install handoff is available.","evidence":["npx skills add addyosmani/agent-skills --skill deprecation-and-migration"]},{"id":"install_safety","label":"Install command safety","status":"pass","score":92,"required_for_auto_install":true,"detail":"standard package or runtime install path","evidence":["npx skills add addyosmani/agent-skills --skill deprecation-and-migration"]},{"id":"trust_score","label":"Trust score","status":"pass","score":85,"required_for_auto_install":true,"detail":"Good trust signals with a few areas worth checking before rollout.","evidence":["Strong shortlist","91K GitHub stars","MIT"]},{"id":"audit_score","label":"Audit score","status":"warn","score":90,"required_for_auto_install":true,"detail":"Needs review","evidence":["Permission surface may require sandboxing"]},{"id":"agent_safety_gate","label":"Agent safety gate","status":"warn","score":70,"required_for_auto_install":true,"detail":"Usable candidate, but the agent should surface permission and audit notes before installation.","evidence":["Require human approval before installing into a real workspace.","Permission surface may require sandboxing"]},{"id":"readme_skillmd_completeness","label":"README/SKILL.md completeness","status":"pass","score":86,"required_for_auto_install":false,"detail":"Metadata includes enough usage and workflow context","evidence":["Strong README/SKILL.md context"]},{"id":"license_clarity","label":"License clarity","status":"pass","score":86,"required_for_auto_install":true,"detail":"MIT","evidence":["MIT"]},{"id":"recent_maintenance","label":"Recent maintenance","status":"pass","score":100,"required_for_auto_install":false,"detail":"8d since push","evidence":["8d since push"]},{"id":"permission_surface","label":"Permission surface","status":"warn","score":60,"required_for_auto_install":true,"detail":"filesystem or document access, network or browser access","evidence":["Network access: medium","Filesystem access: medium","Database access: medium"]},{"id":"alternatives","label":"Alternatives available","status":"info","score":55,"required_for_auto_install":false,"detail":"No close alternatives were found in the current shortlist.","evidence":[]}],"endpoints":{"web":"https://www.openagentskill.com/skills/addyosmani-deprecation-and-migration/evals","api":"/api/agent/evals?slug=addyosmani-deprecation-and-migration","text":"/api/agent/evals?slug=addyosmani-deprecation-and-migration&format=text"}},"agent_readable_metadata":{"version":"openagentskill-agent-metadata-v2","skill":{"slug":"addyosmani-deprecation-and-migration","name":"deprecation-and-migration","description":"Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.","category":"coding-agents","url":"https://www.openagentskill.com/skills/addyosmani-deprecation-and-migration","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration","github_repo":"addyosmani/agent-skills"},"suited_tasks":["Database and SQL workflows","Claude Code teams","teams that value GitHub adoption signals","Understand table relationships","Write safer queries","Explain database changes","Inspect repository metadata","Compare code changes"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI","CLI"],"install":{"command":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add addyosmani-deprecation-and-migration"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"deprecation-and-migration\" agent skill from https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-deprecation-and-migration\",\"task\":\"Install deprecation-and-migration\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"deprecation-and-migration\" as a Claude Code skill from https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-deprecation-and-migration\",\"task\":\"Install deprecation-and-migration\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"deprecation-and-migration\" from https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-deprecation-and-migration\",\"task\":\"Install deprecation-and-migration\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."}],"handoff_url":"https://www.openagentskill.com/api/skills/addyosmani-deprecation-and-migration/install","manifest_url":"https://www.openagentskill.com/api/registry/manifest/addyosmani-deprecation-and-migration"},"trust":{"score":85,"label":"Strong shortlist","version":"trust-score-v4","install_policy":"human_review_before_install","evidence":{"stars":"91K GitHub stars","repoActivity":"91K stars, 9.8K forks","lastPushed":"8d since push","license":"MIT","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration","install":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet"},"outcome_evidence":{"total":0,"successes":0,"failures":0,"not_relevant":0,"success_rate":null,"recent_success_rate":null,"recent_failure_rate":null,"install_attempts":0,"install_success_rate":null,"risk_blocked":0,"setup_required":0,"avg_output_quality":null,"production_outcomes":0,"last_outcome_at":null,"label":"No agent outcome data yet"},"auto_install":{"allowed":false,"sandbox_required":true,"reason":"Human review or sandbox validation is required before automatic installation."},"best_for":["coding-agents","agent-skill"],"known_risks":["Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"audit":{"score":90,"risk_level":"needs_review","risk_label":"Needs review","warnings":["Permission surface may require sandboxing","Financial research output is not financial advice; require human review before any live investment decision","Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"safety_gate":{"tier":"reviewed","label":"Reviewed with permission notes","auto_install_policy":"review","auto_install_allowed":false,"human_review_required":true,"blocked":false,"recommended_action":"Require human approval before installing into a real workspace."},"quality":{"score":95,"label":"Excellent"},"supply":{"track":"Coding and developer agents","scenario":"Database and SQL","maintenance":"8d since push","risk":"Needs review"},"alternative_skills":[],"do_not_use_when":["teams that need a vendor-supported SLA","high-compliance environments without internal security review","No OpenAgentSkill engagement data yet","Permission surface may require sandboxing","Financial research output is not financial advice; require human review before any live investment decision","Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"],"agent_contract":{"task_input":"Use deprecation-and-migration in an agent workflow","recommended_action":"Require human approval before installing into a real workspace.","install_policy":"review","minimum_review_before_use":["Trust: 85/100 Strong shortlist","Audit: 90/100 Needs review","Safety: 70/100 Review before install","Review repository, license, install command, and permission surface before production use."],"expected_agent_output":{"selected_skill":"addyosmani-deprecation-and-migration (deprecation-and-migration)","install_command":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","risk_summary":"Needs review; Reviewed with permission notes; Review before production","verification_result":"Report the smallest successful task, files touched, warnings, and any missing setup."}},"outcome_feedback":{"endpoint":"https://www.openagentskill.com/api/agent/outcome","method":"POST","requires_resolve_event_id":true,"event_id_source":"Use install_receipt.outcome_feedback.event_id or feedback.event_id returned by /api/agent/resolve for the current task.","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"payload_template":{"event_id":"<install_receipt.outcome_feedback.event_id or feedback.event_id from /api/agent/resolve>","skill_slug":"addyosmani-deprecation-and-migration","task":"Use deprecation-and-migration in an agent workflow","agent":"codex","outcome":"success","install_used":true,"risk_blocked":false,"setup_required":false,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"workspace":"sandbox","time_to_useful_ms":120000,"notes":"Report the smallest successful task, setup friction, files touched, and risk notes."}},"endpoints":{"web":"https://www.openagentskill.com/skills/addyosmani-deprecation-and-migration","api":"https://www.openagentskill.com/api/agent/skills/addyosmani-deprecation-and-migration","audit":"https://www.openagentskill.com/skills/addyosmani-deprecation-and-migration/audit","eval":"https://www.openagentskill.com/api/agent/evals?slug=addyosmani-deprecation-and-migration&task=Use%20deprecation-and-migration%20in%20an%20agent%20workflow&max_risk=medium","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Use%20deprecation-and-migration%20in%20an%20agent%20workflow&agent=codex&max_risk=medium","receipt":"https://www.openagentskill.com/api/agent/receipt?task=Use%20deprecation-and-migration%20in%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text","install":"https://www.openagentskill.com/api/skills/addyosmani-deprecation-and-migration/install","manifest":"https://www.openagentskill.com/api/registry/manifest/addyosmani-deprecation-and-migration"}},"machine_metadata":{"version":"openagentskill-agent-metadata-v2","skill":{"slug":"addyosmani-deprecation-and-migration","name":"deprecation-and-migration","description":"Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.","category":"coding-agents","url":"https://www.openagentskill.com/skills/addyosmani-deprecation-and-migration","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration","github_repo":"addyosmani/agent-skills"},"suited_tasks":["Database and SQL workflows","Claude Code teams","teams that value GitHub adoption signals","Understand table relationships","Write safer queries","Explain database changes","Inspect repository metadata","Compare code changes"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI","CLI"],"install":{"command":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add addyosmani-deprecation-and-migration"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"deprecation-and-migration\" agent skill from https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-deprecation-and-migration\",\"task\":\"Install deprecation-and-migration\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"deprecation-and-migration\" as a Claude Code skill from https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-deprecation-and-migration\",\"task\":\"Install deprecation-and-migration\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"deprecation-and-migration\" from https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-deprecation-and-migration\",\"task\":\"Install deprecation-and-migration\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."}],"handoff_url":"https://www.openagentskill.com/api/skills/addyosmani-deprecation-and-migration/install","manifest_url":"https://www.openagentskill.com/api/registry/manifest/addyosmani-deprecation-and-migration"},"trust":{"score":85,"label":"Strong shortlist","version":"trust-score-v4","install_policy":"human_review_before_install","evidence":{"stars":"91K GitHub stars","repoActivity":"91K stars, 9.8K forks","lastPushed":"8d since push","license":"MIT","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration","install":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet"},"outcome_evidence":{"total":0,"successes":0,"failures":0,"not_relevant":0,"success_rate":null,"recent_success_rate":null,"recent_failure_rate":null,"install_attempts":0,"install_success_rate":null,"risk_blocked":0,"setup_required":0,"avg_output_quality":null,"production_outcomes":0,"last_outcome_at":null,"label":"No agent outcome data yet"},"auto_install":{"allowed":false,"sandbox_required":true,"reason":"Human review or sandbox validation is required before automatic installation."},"best_for":["coding-agents","agent-skill"],"known_risks":["Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"audit":{"score":90,"risk_level":"needs_review","risk_label":"Needs review","warnings":["Permission surface may require sandboxing","Financial research output is not financial advice; require human review before any live investment decision","Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"safety_gate":{"tier":"reviewed","label":"Reviewed with permission notes","auto_install_policy":"review","auto_install_allowed":false,"human_review_required":true,"blocked":false,"recommended_action":"Require human approval before installing into a real workspace."},"quality":{"score":95,"label":"Excellent"},"supply":{"track":"Coding and developer agents","scenario":"Database and SQL","maintenance":"8d since push","risk":"Needs review"},"alternative_skills":[],"do_not_use_when":["teams that need a vendor-supported SLA","high-compliance environments without internal security review","No OpenAgentSkill engagement data yet","Permission surface may require sandboxing","Financial research output is not financial advice; require human review before any live investment decision","Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"],"agent_contract":{"task_input":"Use deprecation-and-migration in an agent workflow","recommended_action":"Require human approval before installing into a real workspace.","install_policy":"review","minimum_review_before_use":["Trust: 85/100 Strong shortlist","Audit: 90/100 Needs review","Safety: 70/100 Review before install","Review repository, license, install command, and permission surface before production use."],"expected_agent_output":{"selected_skill":"addyosmani-deprecation-and-migration (deprecation-and-migration)","install_command":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","risk_summary":"Needs review; Reviewed with permission notes; Review before production","verification_result":"Report the smallest successful task, files touched, warnings, and any missing setup."}},"outcome_feedback":{"endpoint":"https://www.openagentskill.com/api/agent/outcome","method":"POST","requires_resolve_event_id":true,"event_id_source":"Use install_receipt.outcome_feedback.event_id or feedback.event_id returned by /api/agent/resolve for the current task.","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"payload_template":{"event_id":"<install_receipt.outcome_feedback.event_id or feedback.event_id from /api/agent/resolve>","skill_slug":"addyosmani-deprecation-and-migration","task":"Use deprecation-and-migration in an agent workflow","agent":"codex","outcome":"success","install_used":true,"risk_blocked":false,"setup_required":false,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"workspace":"sandbox","time_to_useful_ms":120000,"notes":"Report the smallest successful task, setup friction, files touched, and risk notes."}},"endpoints":{"web":"https://www.openagentskill.com/skills/addyosmani-deprecation-and-migration","api":"https://www.openagentskill.com/api/agent/skills/addyosmani-deprecation-and-migration","audit":"https://www.openagentskill.com/skills/addyosmani-deprecation-and-migration/audit","eval":"https://www.openagentskill.com/api/agent/evals?slug=addyosmani-deprecation-and-migration&task=Use%20deprecation-and-migration%20in%20an%20agent%20workflow&max_risk=medium","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Use%20deprecation-and-migration%20in%20an%20agent%20workflow&agent=codex&max_risk=medium","receipt":"https://www.openagentskill.com/api/agent/receipt?task=Use%20deprecation-and-migration%20in%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text","install":"https://www.openagentskill.com/api/skills/addyosmani-deprecation-and-migration/install","manifest":"https://www.openagentskill.com/api/registry/manifest/addyosmani-deprecation-and-migration"}},"supply_profile":{"track":{"slug":"coding","label":"Coding and developer agents","shortLabel":"Coding","description":"Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills."},"scenario":{"label":"Database and SQL","description":"I need my agent to inspect database schemas, write SQL, and explain query results.","useCases":[{"slug":"database-sql","title":"Database and SQL"},{"slug":"github-automation","title":"GitHub automation"},{"slug":"testing-qa","title":"Testing and QA"}]},"applicableAgents":["Claude Code","CLI","Codex","Cursor"],"install":{"ready":true,"command":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","primaryTarget":"CLI","targetCount":4},"githubQuality":{"stars":91373,"starsLabel":"91K","forks":9758,"license":"MIT","qualityScore":95,"trustScore":85,"auditScore":90},"maintenance":{"status":"fresh","label":"8d since push","daysSincePush":8,"lastPushedAt":"2026-08-28T23:31:50+00:00"},"risk":{"level":"needs_review","label":"Needs review","requiresReview":true,"notes":["Permission surface may require sandboxing","Financial research output is not financial advice; require human review before any live investment decision","Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"coverageTags":["Coding","Database and SQL","coding-agents","agent-skill"]},"audit":{"audit_score":90,"risk_level":"needs_review","risk_label":"Needs review","quality_score":95,"trust_score":85,"maintenance_score":100,"security_score":84,"install_score":92,"warnings":["Permission surface may require sandboxing","Financial research output is not financial advice; require human review before any live investment decision","Financial research output is not financial advice; require human review before any live investment decision.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"quality_signals":{"model":"v2","star_score":34.73,"usage_score":0,"review_score":5.1,"metadata_score":3,"freshness_score":15},"platforms":["Claude Code"],"use_cases":[{"slug":"database-sql","title":"Database and SQL","url":"https://www.openagentskill.com/use-cases/database-sql"},{"slug":"github-automation","title":"GitHub automation","url":"https://www.openagentskill.com/use-cases/github-automation"},{"slug":"testing-qa","title":"Testing and QA","url":"https://www.openagentskill.com/use-cases/testing-qa"},{"slug":"coding-agents","title":"Coding agents","url":"https://www.openagentskill.com/use-cases/coding-agents"}],"stacks":[{"slug":"browser-qa-agent","title":"Browser QA agent","url":"https://www.openagentskill.com/collections/browser-qa-agent"},{"slug":"coding-review-agent","title":"Coding review agent","url":"https://www.openagentskill.com/collections/coding-review-agent"},{"slug":"frontend-product-ui","title":"Frontend and UI","url":"https://www.openagentskill.com/collections/frontend-product-ui"}],"install":"npx skills add addyosmani/agent-skills --skill deprecation-and-migration","install_targets":[{"id":"openagentskill-cli","label":"CLI","title":"OpenAgentSkill CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add addyosmani-deprecation-and-migration","description":"Resolve policy, run the source installer safely, and report a verified install receipt.","copyLabel":"Copy command"},{"id":"codex","label":"Codex","title":"Codex install prompt","kind":"agent-prompt","value":"Install the \"deprecation-and-migration\" agent skill from https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-deprecation-and-migration\",\"task\":\"Install deprecation-and-migration\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Give Codex a repo-aware install prompt when the skill is not available through a local CLI.","copyLabel":"Copy prompt"},{"id":"claude-code","label":"Claude Code","title":"Claude Code skill prompt","kind":"agent-prompt","value":"Add \"deprecation-and-migration\" as a Claude Code skill from https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-deprecation-and-migration\",\"task\":\"Install deprecation-and-migration\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Use this prompt to ask Claude Code to add the skill and explain the local activation steps.","copyLabel":"Copy prompt"},{"id":"cursor","label":"Cursor","title":"Cursor rule prompt","kind":"agent-prompt","value":"Turn \"deprecation-and-migration\" from https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-deprecation-and-migration\",\"task\":\"Install deprecation-and-migration\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Use this when installing as Cursor project rules or reusable agent instructions.","copyLabel":"Copy prompt"}],"repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration","github_repo":"addyosmani/agent-skills","version":"1.0.0","license":"MIT","urls":{"web":"https://www.openagentskill.com/skills/addyosmani-deprecation-and-migration","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration","api":"/api/agent/skills/addyosmani-deprecation-and-migration","install_api":"/api/skills/addyosmani-deprecation-and-migration/install"},"meta":{"created_at":"2026-09-01T14:41:15.951302+00:00","updated_at":"2026-09-01T14:41:16.152017+00:00","agent_friendly":true}}