Skill Refactor
Scan Codex session history for skill failures, usage patterns, and coverage gaps. Use when the user wants daily skill-health monitoring or evidence-backed recommendations about installing, improving, merging, or pruning skills.
Install
npx skills add jscraik/Agent-Skills --skill skill-refactorgit clone --depth 1 https://github.com/jscraik/Agent-Skills.git /tmp/Agent-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/Agent-Skills/Infrastructure/references/deferred-skill-context/skill-factory-skill-refactor ~/.claude/skills/skill-refactorPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Skill Refactor Analyze skill reliability from session evidence and return prioritized recommendations. Read when: evidence schema or audit criteria are needed: [contract](./references/contract.yaml) Read when: session history must be inventoried or extracted before synthesis: [session evidence workflow](./references/session-evidence-workflow.md) ## Philosophy - Evidence first: recommendations must be traceable to concrete session artifacts. - Favor high-leverage fixes that reduce repeated failures across multiple skills. - Keep recommendations executable by mapping each finding to a clear next action. ## When to use - Use when the user asks for evidence-backed skill reliability analysis from session history. - Use when deciding whether to install, improve, merge, or retire skills. ## Required inputs - A clear analysis scope (single skill, category, or full inventory). - Session evidence sources or local artifacts available for review, preferably a `~/.agents/session-collector` bundle for broad session scope. - Ranking criteria for severity and impact. ## Deliverables - Prioritized findings with explicit evidence links or file references. - Recommended actions grouped by keep, improve, merge, or retire. - A short risk note for any recommendation that could remove capabilities. - Structured output includes `schema_version: 1` when requested or when automation will consume the result. ## Procedure 1. Define scope: single skill, lane, or full inventory.
Details
- Skill name
skill-refactor- Repository
- jscraik/Agent-Skills
- Path
Infrastructure/references/deferred-skill-context/skill-factory-skill-refactor/SKILL.md- License
- Apache-2.0
- Repo updated
- 16 November 2026
FAQ
What does the Skill Refactor skill do?
Scan Codex session history for skill failures, usage patterns, and coverage gaps. Use when the user wants daily skill-health monitoring or evidence-backed recommendations about installing, improving, merging, or pruning skills.
How do I install the Skill Refactor skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add jscraik/Agent-Skills --skill skill-refactor. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Skill Refactor popular?
It lives in jscraik/Agent-Skills, which has 9 GitHub stars and 4 forks.
Related skills
1password
9jscraik/Agent-Skills
Plan, diagnose, and validate 1Password CLI workflows. Use when tasks need op CLI sign-in, secret references, op run, op inject, item reads, env injection, or service-account secret access.
Agentation
9jscraik/Agent-Skills
Audit, validate, and troubleshoot Agentation integrations in frontend apps. Use when annotations, MCP registration, endpoint sync, webhook delivery, or watch mode readiness are failing.
Agents Md
9jscraik/Agent-Skills
Use when reviewing, creating, shrinking, or refactoring AGENTS.md and directly linked instruction guidance for stale or conflicting rules against current model documentation, scoped routing, deduplication, or progressive disclosure.
Skill Refactor
9jscraik/Agent-Skills
Analyzes bounded skill evidence, classifies root causes, and recommends a lifecycle lane such as keep, observe, improve through Skill Factory hardening, merge with approval, or retire with approval. Use when a skill is not working, a skill is not triggering correctly, evals or Tessl disagree, repeated failures need debugging, or skill performance issues need evidence-backed repair handoff items.
Skill Factory Router
9jscraik/Agent-Skills
Review Codex skill-management intent to select its downstream owner. Use when the owner is ambiguous or the user explicitly asks for routing, not when a downstream lane is already clear.
Sy Execution Plan
9jscraik/Agent-Skills
Plan how to implement one approved slice, including file targets, validation gates, rollback, and proof lanes. Use when a slice spec is accepted and the user needs the implementation order before code changes.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.