SkillCreator v0.1

本地运行的 Agent-Skill 创建/安装工具，支持 Claude Code 和 Codex 的 skills 的创建和查看，引导您快速生成正确格式的 skill。

1. 功能简介

• 选择目标目录（Claude Code / Codex / 自定义）并扫描已有 skills。
• 创建新 skill：填写信息、上传附加文件、生成 SKILL.md。
• 一键安装到目标目录，支持重名策略（自动重命名 / 覆盖 / 取消）。
• 前端支持中英文切换（默认英文，配置持久化到 ~/.skillcreator/config.json）。

2. 环境要求

• Python 3.9+
• pip

3. 安装与启动

pip install -r requirements.txt
python app.py

如你的环境命令是 python3，请改用 python3 app.py。

启动后会：

• 绑定 127.0.0.1
• 端口优先使用 7860（被占用会自动切换）
• 自动打开默认浏览器

4. 使用流程（建议）

1. 首页进入 Create Skill 或 Existing Skills。
2. 在顶部设置目标与 Skill Directory。
3. Create Skill：
   • 填写 Skill Name / Display Name / Description / Usage / Notes
   • 上传文件（支持多文件；.zip 会解压到 skill 根目录）
   • 点击 Generate，再点击 Install
4. Existing Skills：
   • 自动扫描（进入页面时）
   • 点击某个 skill 查看路径与摘要

5. 上传与压缩包规则

• 普通文件：允许上传，生成时复制到 skill 根目录。
• .zip：允许上传，生成时自动解压（含路径安全校验）。
• .rar / .7z：当前版本不自动解压，会提示先本地解压或转为 .zip。
• 其他压缩格式（如 .tar.gz 等）：不支持。

6. 界面截图

7. 项目结构

app.py
backend/
  core.py
  models.py
  config.py
frontend/
  index.html
  main.js
  styles.css
generated_skills/   # 运行时生成
_uploads/           # 运行时临时上传

8. API（v0.1）

• GET /api/default-paths
• POST /api/scan
• POST /api/skill-detail
• POST /api/upload
• POST /api/upload-delete
• POST /api/generate
• POST /api/install
• GET /api/settings/language
• POST /api/settings/language

9. 安全说明（公开仓库相关）

• 所有路径逻辑使用 pathlib，不会将用户输入作为 shell 命令执行。
• 上传/解压包含路径穿越防护（拒绝 ..、绝对路径等）。