Makepad Skills Evolution

This skill enables makepad-skills to self-improve continuously during development.

When to Use

You are maintaining makepad-skills and want the skill library to improve itself during development.
You need the workflow for deciding when a new pattern should become a skill update or hook-driven evolution.
You are working on self-correction, self-validation, or version adaptation for the skill set.

Quick Navigation

Topic	Description
Collaboration Guidelines	Contributing to makepad-skills
Hooks Setup	Auto-trigger evolution with hooks
When to Evolve	Triggers and classification
Evolution Process	Step-by-step guide
Self-Correction	Auto-fix skill errors
Self-Validation	Verify skill accuracy
Version Adaptation	Multi-branch support

Hooks-Based Auto-Triggering

For reliable automatic triggering, use Claude Code hooks. Install with --with-hooks:

# Install makepad-skills with hooks enabled
tmpdir="$(mktemp -d)"
trap 'rm -rf "$tmpdir"' EXIT
curl -fsSLo "$tmpdir/makepad-skills-install.sh" https://raw.githubusercontent.com/ZhangHanDong/makepad-skills/main/install.sh
sed -n '1,160p' "$tmpdir/makepad-skills-install.sh"
bash "$tmpdir/makepad-skills-install.sh" --with-hooks

This will install hooks to .claude/hooks/ and configure .claude/settings.json:

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "bash .claude/hooks/makepad-skill-router.sh"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash|Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "bash .claude/hooks/pre-tool.sh"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "bash .claude/hooks/post-bash.sh"
          }
        ]
      }
    ]
  }
}

What Hooks Do

Hook	Trigger Event	Action
`makepad-skill-router.sh`	UserPromptSubmit	Auto-route to relevant skills
`pre-tool.sh`	Before Bash/Write/Edit	Detect Makepad version from Cargo.toml
`post-bash.sh`	After Bash command fails	Detect Makepad errors, suggest fixes
`session-end.sh`	Session ends	Prompt to capture learnings

Skill Routing and Bundling

The makepad-skill-router.sh hook automatically loads relevant skills based on user queries.

Context Detection

Context	Trigger Keywords	Skills Loaded
Full App	"build app", "从零", "完整应用"	basics, dsl, layout, widgets, event-action, app-architecture
UI Design	"ui design", "界面设计"	dsl, layout, widgets, animation, shaders
Widget Creation	"create widget", "创建组件", "自定义组件"	widgets, dsl, layout, animation, shaders, font, event-action
Production	"best practice", "robrix pattern", "实际项目"	app-architecture, widget-patterns, state-management, event-action

Skill Dependencies

When loading certain skills, related skills are auto-loaded:

Primary Skill	Auto-loads
robius-app-architecture	makepad-basics, makepad-event-action
robius-widget-patterns	makepad-widgets, makepad-layout
makepad-widgets	makepad-layout, makepad-dsl
makepad-animation	makepad-shaders
makepad-shaders	makepad-widgets
makepad-font	makepad-widgets
robius-event-action	makepad-event-action

Example

User: "我想从零开发一个 Makepad 应用"

[makepad-skills] Detected Makepad/Robius query
[makepad-skills] App development context detected - loading skill bundle
[makepad-skills] Routing to: makepad-basics makepad-dsl makepad-event-action
                            makepad-layout makepad-widgets robius-app-architecture

When to Evolve

Trigger skill evolution when any of these occur during development:

Trigger	Target Skill	Priority
New widget pattern discovered	robius-widget-patterns/_base	High
Shader technique learned	makepad-shaders	High
Compilation error solved	makepad-reference/troubleshooting	High
Layout solution found	makepad-reference/adaptive-layout	Medium
Build/packaging issue resolved	makepad-deployment	Medium
New project structure insight	makepad-basics	Low
Core concept clarified	makepad-dsl/makepad-widgets	Low

Evolution Process

Step 1: Identify Knowledge Worth Capturing

Ask yourself:

Is this a reusable pattern? (not project-specific)
Did it take significant effort to figure out?
Would it help other Makepad developers?

evolution

Documentation

Makepad Skills Evolution

When to Use

Quick Navigation

Hooks-Based Auto-Triggering

What Hooks Do

Skill Routing and Bundling

Context Detection

Skill Dependencies

Example

When to Evolve

Evolution Process

Step 1: Identify Knowledge Worth Capturing

Use Cases

Quick Info

Tags

Related Skills

007

10-andruia-skill-smith

2slides-ppt-generator