refine-skills

Convert recurring skill.feedback.md patterns into permanent SKILL.md instructions.

Updated Nov 26, 2025

Search Tags:#automation #workflow #feedback #documentation #skills #version-control #refine

Ready to run

npx skills add https://github.com/Aias/dotfiles --skill refine-skills-aias

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: refine-skills
Source: https://github.com/Aias/dotfiles/tree/main/agents/skills/refine-skills
Command: npx skills add https://github.com/Aias/dotfiles --skill refine-skills-aias

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Distill accumulated skill.feedback.md entries into permanent skill instructions, turning raw session corrections into crafted rules and keeping feedback as a staging area rather than a permanent store.

Core Features & Use Cases

Survey feedback files and identify recurring patterns across multiple skills.
Read and analyze each skill's SKILL.md to map patterns to concrete instructions.
Propose, review, and promote stable instructions into SKILL.md; leave one-offs in feedback for future review.
After promotions, run make compile to refresh builds and make link to deploy changes.

Quick Start

Distill feedback into permanent SKILL.md rules by running the refine-skills workflow.

Frequently Asked Questions about refine-skills

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

FAQPage Schema

How do I convert feedback entries into permanent skill rules?▼

To convert feedback entries into permanent skill rules, you identify recurring patterns in skill.feedback.md files and promote them into SKILL.md instructions, leaving one-off entries in the feedback file for future review.

What is the best way to manage skill version control and documentation updates?▼

Managing skill version control involves promoting stable feedback patterns into SKILL.md, running make compile to refresh GLOBAL.md, and executing make link to deploy the documentation changes.

How do I identify recurring patterns across multiple skill feedback files?▼

To identify recurring patterns, survey skill.feedback.md entries across multiple skills and analyze them to find consistent corrections that can be mapped to concrete instructions in SKILL.md.

What happens to one-off feedback entries when promoting skill instructions?▼

One-off feedback entries remain in the skill.feedback.md file for future review, ensuring only consistent, stable patterns are promoted to permanent SKILL.md instructions.

Can I use this workflow to automate documentation updates for all skills with feedback?▼

Yes, this workflow applies to all skills that have accumulated feedback, surveying their feedback files and proposing promotions to ensure consistent patterns are captured in documentation.

Why should I run make compile and make link after promoting feedback to SKILL.md?▼

Running make compile refreshes GLOBAL.md builds and make link deploys changes, ensuring the newly promoted skill instructions are fully integrated and active across the environment.