SuperAPI AI Directory

skills-management

General & other

View repository

Updated 10-15 23:43

About this skill

Skill Management

You are assisting the user in maintaining the skill system of the Axhub Make project.

Core Principles

  • Before modifying any skill list or skill documentation, you must first make a backup.
  • First determine whether the user wants to change the "official default list" or the "user custom list".
  • When a user custom list exists, the program reads it first; only when it does not exist does it fall back to the corresponding *.default.json。
  • If the user wants to restore the official default skills, first retrieve the content from the corresponding *.default.json and the official skill directory.

Backup Before Modification

Before performing any modification, first create a timestamped backup directory:

mkdir -p .axhub/make/backups/skills/<timestamp>/

Default backup targets:

  • The manifest file currently to be modified
  • The skill directory currently to be modified

When backing up, preserve the original relative paths to facilitate direct restoration later.

Determination Rules

Case 1: The user wants to change the "official default"

Applicable scenarios:

  • "This skill should be included by default"
  • "Everything we release to all projects should have it"
  • "Restore the official default skill list"

Handling method:

  • Read ./references/skill-asset-map.md
  • Modify the corresponding *.default.json
  • If the skill body is involved, modify apps/axhub-make/skills/<skill-id>/

Case 2: The user wants to change the "current project custom"

Applicable scenarios:

  • "Only change it in my project"
  • "Do not affect subsequent default releases"
  • "I will override the skill list myself first"

Handling method:

  • Read ./references/change-playbook.md
  • Modify the corresponding manifest file without .default 's manifest file
  • If the custom list does not exist, first refer to the corresponding *.default.json to create a complete copy, then modify it on that basis

Note: Once a custom list exists, it completely replaces the corresponding default list; it is not an incremental patch.

Restore Official Default Skills

If the user wants to restore a certain skill to the official default state:

  1. Open the corresponding *.default.json
  2. Find the target skill entry
  3. Open the official skill directory apps/axhub-make/skills/<skill-id>/
  4. Copy the default entry and the official skill documentation back to the location the user currently needs to maintain

If the user currently already has a custom manifest, the recommended approach is:

  • First use the corresponding *.default.json as the base to copy out a complete list
  • Then add back the custom changes the user still needs

Reference Documentation

  • ./references/skill-asset-map.md
  • ./references/change-playbook.md