better-skill-creator

Advanced skill creation and management tool with automated version control, intelligent diff, risk assessment, rollback, semantic versioning, and test automa...

Security Scan

The skill's code and runtime instructions are consistent with its stated purpose (skill creation, packaging, versioning, rollback) and do not request unrelated credentials or external network access, though it performs potentially destructive local file operations (backups, restores, deletions) which are expected for this functionality.

Purpose & Capability

The name/description match the included scripts (init_skill.py, package_skill.py, backup.py, diff.py, rollback.py, proposal.py, validate-modify.py, mark-stable.py, etc.). No unrelated environment variables, binaries, or external services are requested. The feature set is proportional to the files provided.

Instruction Scope

SKILL.md and the scripts keep scope to skill creation/management. However, the runtime instructions and scripts perform local filesystem operations (copying skill directories to ~/.openclaw/skill-backups, removing/overwriting target directories during rollback, writing proposal metadata) and will prompt for confirmation in some flows. These filesystem changes are coherent with purpose but are potentially destructive if used accidentally.

Install Mechanism

No install spec is provided (instruction-only skill) and all support code is bundled with the skill. There are no downloads from remote URLs or package manager installs that would increase risk.

Credentials

No credentials or environment variables are required. Scripts use user-local paths under the home directory (~/.openclaw/...) to store backups and proposals which is consistent with a versioning tool and does not request unrelated secrets.

Persistence & Privilege

The skill does not require always:true and does not request extra privileges, but it writes and deletes files in the user's filesystem (backups and rollbacks). This is expected for its purpose but is an important operational privilege—rollback will remove the current target directory and replace it with backed-up content.

Assessment

This package appears to do what it says: create, package, back up, compare, and roll back skills using local files under ~/.openclaw. Before installing or running: (1) Review the bundled scripts yourself—rollback.py and backup.py will remove and overwrite directories and write to ~/.openclaw; ensure you point them at test copies or confirm paths. (2) Be aware rollback uses shutil.rmtree on the target path (destructive) and runs backup via subprocess; keep important data backed up elsewhere. (3) There is no network/exfiltration code found in the provided files, but always inspect any install.py/migrate.py referenced by SKILL.md—SKILL.md mentions migrate.py though that file was not present in the manifest (minor inconsistency to check). (4) Consider running first in a sandbox or VM and ensure you have filesystem backups for any real skill directories you care about.

Better Skill Creator - Enhanced Skill Creation and Management Tool

Core Features

🎯 100% Compatible with native skill-creator

All native functions are fully retained with zero switching of usage habits:

• Skill initialization template generation (init_skill.py)
• Skill directory structure specification verification
• Skill packaging and export (package_skill.py)
• Skill design best practice guidance
• Full compatibility with all original parameters and commands

🛡️ Built-in end-to-end version control (New capabilities)

No additional version management tools required, ready to use out of the box:

1. Automatic Backup: Automatically triggers version backup before creating/modifying skills, no manual operation required
2. Intelligent Diff Comparison: Compare content differences of any versions, automatically identify change types and assess risk levels (High/Medium/Low)
3. Interactive Rollback: Automatically list version records, roll back by selection, support difference preview
4. Requirement Plan Control: Built-in optimization plan generation + approval process, enforce "confirm the plan before modification"
5. Semantic Version Number: Automatically manage version numbers, with complete and traceable version records
6. Automatic CHANGELOG Generation: Automatically generate version change records for each modification

✨ New Enhanced Capabilities

• 📊 Automatic assessment of the impact scope of skill modifications
• 🧪 Built-in automatic test case execution, automatic function verification after modification
• 🔒 Stable version marking function, marked versions are permanently retained and will not be automatically cleaned up
• 📝 Automatic generation of version change reports, clearly recording every modification

Installation Instructions

Automatic Conflict Detection

Automatically detect the following old versions during installation, support intelligent migration:

• Native skill-creator built into the system
• Installed old versions of skill-creator
• Installed skill-version-control
• Automatically migrate all historical backups, version records, and optimization plan data

Installation Command

python scripts/install.py

Core Usage Process

1. Create a New Skill

python scripts/init_skill.py <skill-name> --path <output-directory>

Automatically create version records, initial version number v1.0.0

2. Optimize Existing Skills

graph TD A[User submits optimization requirements] --> B[Generate optimization plan] B --> C[User confirms the plan] C --> D[Automatically back up the current version] D --> E[Modify skills according to the plan] E --> F[Automatic diff comparison + risk assessment] F --> G[Automatically run test cases] G --> H[Generate new version records + CHANGELOG]

3. View Version List

python scripts/list.py <skill-name>

4. Roll Back to Historical Versions

Interactive rollback (Recommended)

python scripts/interactive-rollback.py <skill-name>

Direct rollback

python scripts/rollback.py <skill-name> <version-ID>

5. Compare Version Differences

python scripts/diff.py <skill-name> <version-ID1> [version-ID2]

6. Generate Optimization Plan

Generate plan

python scripts/proposal.py generate <skill-name> "Requirement description" --version v1.1.0

View all plans

python scripts/proposal.py list

7. Package Skills

python scripts/package_skill.py <skill-path>

Script Descriptions

Native Function Scripts

• init_skill.py: Initialize new skill templates
• package_skill.py: Package skills into .skill files

Version Management Scripts

• backup.py: Version backup
• list.py: Version list query
• diff.py: Intelligent diff comparison + risk assessment
• rollback.py: Version rollback
• interactive-rollback.py: Interactive version rollback
• proposal.py: Optimization plan generation and management
• install.py: Installation script + conflict detection
• migrate.py: Historical data migration script

Configuration Instructions

Refer to references/config.md, support custom backup directories, number of retained versions, etc.