Skillora

English

多平台 AI 代理技能管理工具，支持 Claude Code、Cursor、Codex/GPT、Gemini、Windsurf、Aider 等平台。

特点

• 多平台支持 - 一套技能，多平台使用（Claude Code、Cursor、Codex、Gemini、Windsurf、Aider）
• 斜杠命令 - Claude Code 原生支持 /ora/<skill-name> 命令调用
• SKILL.md 格式 - 标准化的技能定义格式，易于扩展和维护
• 灵活安装 - 支持项目级、通用级、全局级三种安装模式
• 零配置 - 交互式初始化，自动生成平台配置文件

安装

npm i -g @tinkcarlos/skillora

需要 Node.js 20.6+

快速开始

交互式初始化（推荐）

skillora init

交互式选择平台和安装模式，自动生成配置文件。

非交互式初始化

# 仅 Claude Code
skillora init --platform claude-code

# 多平台
skillora init --platform claude-code,cursor

# 指定安装模式
skillora init --platform claude-code --universal  # 通用模式
skillora init --platform claude-code --global     # 全局模式

核心技能

Skillora 内置以下核心技能，覆盖软件开发全流程：

开发类

| 技能 | 命令 | 说明 | |------|------|------| | 需求分析 | /ora/product-requirements | PRD 编写、用户故事、验收标准、竞品分析 | | 全栈开发 | /ora/fullstack-developer | 前后端开发、API 设计、数据库迁移、技能编排 | | Bug 修复 | /ora/bug-fixing | 零回归修复、根因分析、知识提取、上下文隔离 | | 代码审查 | /ora/code-review | 分层检查、批量处理、调用链分析、进度追踪 |

前端类

| 技能 | 命令 | 说明 | |------|------|------| | 前端设计 | /ora/frontend-design | 57 种 UI 风格、95 种配色、响应式设计、无障碍审查 | | React 最佳实践 | skillora read react-best-practices | 性能优化、状态管理、渲染优化 |

后端类

| 技能 | 命令 | 说明 | |------|------|------| | API 脚手架 | skillora read api-scaffolding | FastAPI/Django/Express/NestJS 模板 | | API 测试 | skillora read api-testing-observability | 契约测试、Mock 服务、可观测性 | | 数据库迁移 | skillora read database-migrations | SQL 迁移、版本控制、回滚策略 |

工程类

| 技能 | 命令 | 说明 | |------|------|------| | CI/CD 流水线 | skillora read cicd-pipeline | GitHub Actions、GitLab CI、DevSecOps | | 容器化 | skillora read containerization | Docker、Kubernetes、Helm | | 安全审计 | skillora read security-audit | OWASP Top 10、漏洞扫描 | | 性能优化 | skillora read performance-optimization | 性能分析、瓶颈定位 |

流程类

| 技能 | 命令 | 说明 | |------|------|------| | 头脑风暴 | skillora read brainstorming | 苏格拉底式提问、快速设计探索 | | TDD 开发 | skillora read test-driven-development | 测试驱动开发流程 | | Git Worktree | skillora read using-git-worktrees | 多分支并行开发 | | 完成验证 | skillora read verification-before-completion | 合并前检查清单 |

使用说明

Claude Code 中使用

Claude Code 原生支持斜杠命令调用技能：

/ora/bug-fixing      # 启动 Bug 修复流程
/ora/code-review     # 启动代码审查流程
/ora/frontend-design # 启动前端设计流程
/ora/product-requirements # 启动需求分析流程

也可以使用 Skill 工具：

Skill("bug-fixing")
Skill("code-review")

其他平台使用

Cursor、Codex、Gemini、Windsurf、Aider 等平台通过 CLI 命令加载技能：

# 读取技能内容（AI agent 会自动执行）
skillora read bug-fixing
skillora read code-review
skillora read frontend-design

技能搜索

# 列出所有已安装技能
skillora list

# 从特定目录列出
skillora list --global      # 全局技能
skillora list --universal   # 通用技能

命令参考

| 命令 | 说明 | |------|------| | skillora init | 交互式初始化项目 | | skillora install | 安装内置技能 | | skillora list | 列出已安装技能 | | skillora read <name> | 读取技能内容（给 AI agent 用） | | skillora sync | 同步配置到 AGENTS.md | | skillora remove <name> | 删除技能 |

通用选项

| 选项 | 说明 | |------|------| | -g, --global | 操作全局技能目录 (~/.claude/skills/) | | -u, --universal | 操作通用技能目录 (.agent/skills/) | | -t, --target <path> | 操作自定义目录 | | -f, --force | 强制覆盖已存在的技能 |

支持的平台

| 平台 | 配置文件 | 调用方式 | |------|----------|----------| | Claude Code | .claude/skills/, CLAUDE.md | /ora/<skill> 或 Skill("<skill>") | | Cursor | .cursorrules, AGENTS.md | skillora read <skill> | | Codex/GPT | AGENTS.md (System Prompt) | skillora read <skill> | | Gemini | AGENTS.md (System Prompt) | skillora read <skill> | | Windsurf | AGENTS.md | skillora read <skill> | | Aider | AGENTS.md | skillora read <skill> |

安装模式

| 模式 | 目录 | 说明 | |------|------|------| | 项目模式（默认） | .claude/skills/ | 仅当前项目可用 | | 通用模式 | .agent/skills/ | 多代理兼容，项目级 | | 全局模式 | ~/.claude/skills/ | 所有项目共享 |

SKILL.md 格式规范

每个技能由一个目录组成，必须包含 SKILL.md 文件：

my-skill/
├── SKILL.md           # 技能定义（必需）
├── references/        # 参考文档（可选）
│   ├── guide.md
│   └── patterns.md
└── scripts/           # 辅助脚本（可选）
    └── helper.py

SKILL.md 结构

---
name: my-skill
description: 技能的简短描述
user-invocable: true
---

# 技能标题

## 触发条件
描述何时应该使用此技能...

## 工作流程
1. 步骤一
2. 步骤二
...

## 参考文档
- [指南](references/guide.md)

Frontmatter 字段

| 字段 | 类型 | 说明 | |------|------|------| | name | string | 技能名称（用于命令调用） | | description | string | 技能描述 | | user-invocable | boolean | 是否支持用户直接调用（默认 true） |

技能开发

创建新技能

1. 在 .claude/skills/ 下创建技能目录
2. 编写 SKILL.md 文件
3. 运行 skillora sync 更新 AGENTS.md

技能最佳实践

• 单一职责 - 每个技能专注一个领域
• 清晰触发 - 明确描述何时使用此技能
• 结构化流程 - 提供清晰的步骤指引
• 参考分离 - 详细内容放在 references/ 目录

许可证

MIT