Omniskills

English

本文件為繁體中文版本。

Power your ability.

Omniskills 是給 AI agents 使用的 many-skill bank：安裝一個 workflow skill tree，帶著目標呼叫一個 entry skill，就能把適合當前問題的 roles、playbooks、verification habits 交給你的 agent。核心很簡單：3x your ability，而不用手動切換每個 specialist skill。

當你想把 company-building goal 交給多個 role workflows 推進，而不是手動 juggling 每個 skill 時，先從 Startup Goal 開始：CEO、CTO、Product Manager、Web Design、Engineering Manager、Founding Engineer、QA Lead。

快速開始

安裝完整的 startup goal workflow：

npx omniskill@latest install startup-goal

然後請你的 agent 帶著目標執行 entry skill：

$startup-goal I have an AI bookkeeping idea; help me choose the wedge and ship a v1 in two weeks

這個 alias 會指向 repo 內已提交的 workflow bundle：

npx omniskill@latest install 'https://github.com/devos-ing/omni-skills.git#examples/workflows/startup-goal'

如果你只需要單一 specialist workflow，也可以安裝個別 startup roles：

npx omniskill@latest install ceo
npx omniskill@latest install cto
npx omniskill@latest install product-manager
npx omniskill@latest install web-design
npx omniskill@latest install engineering-manager
npx omniskill@latest install founding-engineer
npx omniskill@latest install qa-lead

安裝 skills 後，請重新啟動你的 agent，讓它重新載入新的 entry skills。

Workflow Registry

使用 registry view 挑選一個 Omniskills workflow、檢視它的 role workflow，並複製 install command。

Startup Role Workflows

| Omniskills workflow | Entry skill | 用途 | | --- | --- | --- | | Startup Goal | $startup-goal | 讓 company-building goal 依序經過 strategy、product、interface design、architecture、delivery、implementation、QA role subagents。 | | CEO | $ceo | Direction、hard tradeoffs、fundraising/customer framing、company decisions。 | | CTO | $cto | Architecture、domain model、platform direction、engineering risk。 | | Product Manager | $product-manager | Product discovery、PRDs、acceptance criteria、roadmap tradeoffs、issue slicing。 | | Web Design | $web-design | 可實作的 interface direction、responsive interaction states，以及嚴格的 animation review。 | | Engineering Manager | $engineering-manager | Delivery sequencing、execution risk、quality gates、blocker triage、engineering process。 | | Founding Engineer | $founding-engineer | The smallest correct implementation change：tests、debugging、review、verification。 | | QA Lead | $qa-lead | Release-risk review、acceptance checks、regression focus、reproduction gaps、verification evidence。 |

每個 workflow 仍然只是你可以檢查的檔案：workflow.json、選用的 workflow.lock.json、README、local skills。它的力量來自於一次安裝 skill tree，然後呼叫知道該使用哪些 companion skills 的 entry skill。

Goal Loops

有些 Omniskills workflows 也提供 loop runner，適合需要持續推進直到完成的 goals。loop 是可恢復的 workflow state： loop start 建立 run，loop status 顯示狀態，loop advance 回傳下一個 suggested action。

runtime 是 action-only。它會記錄狀態並回傳下一個 suggested action；它不會默默替 agent 執行 tools 或 shell commands。 預設的 loop run state 會存放在 ~/.omniskills/runs/<workflow-name>/<run-id>/。

試試 loop-capable product-development workflow：

npx omniskill@latest loop start grilled-product-dev --json
npx omniskill@latest loop status grilled-product-dev --latest --json
npx omniskill@latest loop advance grilled-product-dev --run <run-id> --json

這種形狀適合複雜工作：釐清 goal、推進一個 action、驗證 evidence，然後持續 advance 直到 goal 完成。

Built-In Workflow Ecosystem

Omniskills workflows 可以組合 local skills、bundled skills、external skill packs：

• Matt Pocock skills：TDD、review、design pressure-testing、domain modeling、PRDs、issue slicing。
• Superpowers skills：brainstorming、planning、execution、verification。
• Interface Craft skills：提供 design engineering 與 motion 能力。Canonical identifiers 是 interface-craft:design-engineering、interface-craft:motion-vocabulary、 interface-craft:fluid-interface-design、interface-craft:motion-review，並從 emilkowalski/skills 安裝。較舊的 emilkowalski:* identifiers 僅保留為 compatibility aliases。
• Pony Trail 的 history、revert、prehook features 目前暫停。Public workflow installs 不會建立 Pony Trail snapshots。
• More workflow packs are coming.

omniskill install 會使用每個 workflow skill 的 repo metadata，透過 Skills CLI 抓取缺少的 external skills。例如： { "source": "superpowers:brainstorming", "repo": "obra/superpowers" } 會在 source 保留原始 skill name，並用 npx skills add obra/superpowers --skill brainstorming 安裝它。

如果 automatic bootstrap 失敗，請透過 Omniskills 執行 package install，然後重試：

npx omniskill@latest skills install mattpocock/skills

Command Reference

npx omniskill@latest install <alias-or-path-or-git-url>
npx omniskill@latest list
npx omniskill@latest deps <source>
npx omniskill@latest lock <source>
npx omniskill@latest loop <start|status|log|advance|summary> <source>
npx omniskill@latest remove <workflow-name>
npx omniskill@latest onboard
npx omniskill@latest init <name>
npx omniskill@latest validate <source>
npx omniskill@latest skills install
npx omniskill@latest skills update

執行 npx omniskill@latest --help 或 npx omniskill@latest <command> --help 查看詳細用法。

較舊的 bundle command 保留為 init、validate、lock 的 compatibility alias； 較舊的 workflow command 則保留為 install、list、remove 的 compatibility alias。

建立自己的 Omniskills workflow

如果你想 author 並分享 workflow bundle，請先閱讀 Create Your Own Workflow guide。

建立新的 Omniskills workflow：

npx omniskill@latest init release-review

這會建立：

release-review/
  workflow.json
  README.md
  skills/
    release-review/
      SKILL.md
    custom-review/
      SKILL.md

skills/release-review/SKILL.md 是 entry skill。當你希望使用者呼叫一個 skill 來協調多個 sub-skills 時，請編輯它。

如果你希望 agent 協助設計 bundle skills，可以安裝 authoring helper：

npx omniskill@latest skills install creating-bundle-skills

然後要求你的 agent 使用：

$creating-bundle-skills create an Omniskills workflow for release review

分享前請先驗證：

npx omniskill@latest validate ./release-review
npx omniskill@latest deps ./release-review

完整指南在 docs/workflow-author-guide.md。

Examples

| Example | 適合用途 | Notes | | --- | --- | --- | | examples/workflows/startup-goal | 圍繞一個 goal 安裝 realistic startup operating bench。 | 包含 $startup-goal、$ceo、$cto、$product-manager、$web-design、$engineering-manager、$founding-engineer、$qa-lead。 | | examples/workflows/ceo | Company direction、strategy、tradeoffs、decision mapping。 | Uses Matt Pocock decision and grilling skills. | | examples/workflows/cto | Architecture、domain model、technical risk、review。 | Uses Matt Pocock architecture/review skills. | | examples/workflows/product-manager | Discovery、PRD、issue slicing、product planning。 | Uses Superpowers plus Matt Pocock PRD/issue skills. | | examples/workflows/web-design | Interface direction、responsive interaction states、animation review。 | 使用 canonical Interface Craft skill identifiers。 | | examples/workflows/engineering-manager | Delivery sequencing、quality gates、execution risk。 | Uses planning, TDD, diagnosing, and review skills. | | examples/workflows/founding-engineer | Implementation、tests、debugging、review、final verification。 | Uses $implement as the implementation role. | | examples/workflows/qa-lead | Acceptance checks、regression focus、release verification。 | Uses review, diagnosing, and verification skills. | | examples/workflows/grilled-product-dev | 將 product-development work 形成 approved plan 的 goal loops。 | Provides loop start, loop status, and loop advance. | | examples/workflows/openspec-superpowers | OpenSpec delivery 的 compatibility/demo workflow。 | Kept for one release while the role catalog becomes the primary example set. | | examples/workflows/development-design-delivery | Product-minded engineering 的 compatibility/demo workflow。 | Richer composition example with Ponytrail evidence. | | examples/workflows/real-engineering | 組合 RTK、Ponytrail、Superpowers、Matt Pocock skills 的 compatibility/demo workflow。 | Fetches Matt Pocock skills if missing. | | examples/workflows/release-review | Release-risk review 的 compatibility/demo workflow。 | Good minimal example. | | examples/workflows/haaland | Curated playful Haaland/JTS meme workflow。 | 使用 bundled profile asset 產生一張 meme。 |

Installed Files

預設情況下，CLI 會將 installed workflow records 寫入 home directory：

~/.omniskills/workflows/

當你明確需要 project-local workflow record 時，請使用 --dir <project>。

除非你明確想分享 installed workflow records，否則請不要把 project-local .omniskills/ folders 加進 git。

Local Development

bun install
bun run build
bun test
bun run typecheck
bun run coverage
bun run check
bun scripts/smoke-public-git-install.ts

Landing app：

cd landing
bun install
bun run dev
bun run build