skill-forge

Automate iterative improvement of SKILL.md files through mutation and evaluation loops.

16|1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/GodModeAI2025/skill-forge --skill skill-forge-godmodeai2025
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-forge
Source: https://github.com/GodModeAI2025/skill-forge/tree/main
Command: npx skills add https://github.com/GodModeAI2025/skill-forge --skill skill-forge-godmodeai2025

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Skill Forge automates the iterative improvement of AI skills and generic codebases by running a closed-loop experiment that mutates instructions, evaluates changes, and preserves only beneficial improvements, enabling overnight optimization without manual intervention.

Core Features & Use Cases

  • Autonomous Skill Improvement: Optimizes SKILL.md in Skill Mode by running evals, scoring with a composite metric, and keeping only high-impact mutations.
  • Generic-Metric Optimization: Applies the same autoresearch paradigm to any file against a numeric shell metric (e.g., test coverage, bundle size, performance).
  • Robust Workflow: Includes a setup wizard, dry-run validation, TSV experiment logs, coverage matrix, crash recovery, and an optional guided mode for hands-on control.
  • Overnight and Scheduled Runs: Supports scheduled tasks that run unattended and deliver a morning report.
  • Real-world scenarios: improve a LinkedIn-post skill, reduce Docker image size, or improve code quality.

Quick Start

Tell Skill Forge to auto-tune the target SKILL.md to maximize the designated evaluation metric.

Frequently Asked Questions about skill-forge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate AI skill improvement overnight without manual intervention?

Automate AI skill improvement by running an autoresearch loop that mutates target files, evaluates changes, and preserves only beneficial mutations. Skill Forge supports scheduled tasks to run unattended overnight and deliver a morning report.

What is autonomous codebase optimization and how does mutation evaluation work?

Autonomous codebase optimization mutates target files and scores them against a numeric shell metric, like test coverage or bundle size. The evaluation mechanism keeps high-impact mutations and automatically reverts harmful regressions.

Can I optimize arbitrary shell metrics like Docker image size or test coverage?

Yes, you can optimize arbitrary shell metrics like Docker image size or test coverage using Generic Mode. It applies the autoresearch paradigm to mutate any target file against a numeric shell metric to reduce size or improve quality.

How do I set up and validate skill mutations before running them unattended?

Set up and validate skill mutations using the built-in setup wizard and dry-run validation. You can use the optional Guided mode for interactive control to validate changes before scheduling unattended overnight optimization runs.

What happens if an automated code mutation crashes or causes a regression?

If an automated code mutation crashes or causes a regression, crash handling mechanisms recover the process and harmful mutations are automatically revoked by reverting the files. TSV experiment logs track all changes for safety.