aweskill
Use when managing aweskill store, bundle, and agent workflows that are not repair-first: routine commands, bundle template work, multi-agent or multi-scope projection planning, recover flows, skill migration, install/remove/configure tasks. 中文触发词:技能管理、导入技能、投影技能、启用/禁用技能、安装/移除技能、bundle、agent、aweskill、高级技能管理、recover、技能迁移。
Webioinfo01 · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add Webioinfo01/aweskill --skill aweskill技能说明
name: aweskill description: "Use when managing aweskill store, bundle, and agent workflows that are not repair-first: routine commands, bundle template work, multi-agent or multi-scope projection planning, recover flows, skill migration, install/remove/configure tasks. 中文触发词:技能管理、导入技能、投影技能、启用/禁用技能、安装/移除技能、bundle、agent、aweskill、高级技能管理、recover、技能迁移。"
Aweskill
Use aweskill CLI directly. Do not add wrapper scripts unless the CLI is missing a needed capability.
Intent Router
Match the user's intent to a task domain, then follow the workflow below.
| User intent | Domain | First command |
|---|---|---|
| "Find a skill for X", "search skills", "install from GitHub" | Source Lifecycle | aweskill find <query> |
| "Scan and import local skills", "what's in the store", "remove a skill from the store" | Store Work | aweskill store list --verbose |
| "Create a bundle", "add skills to a bundle", "show bundle contents" | Bundle Work | aweskill bundle list --verbose |
| "Give Codex skill X", "project a bundle to Cursor", "remove a projection" | Projection Work | aweskill agent list --verbose |
| "Update a skill", "refresh skills", "更新技能" | Source Lifecycle | aweskill update --check <skill...> when skills are named, else aweskill update --check |
| "Update aweskill itself", "upgrade the CLI" | Self-Update | aweskill self-update --check |
| "Make me a skill", "turn this workflow into a skill", "做一个技能" | Authoring | Hand off to $aweskill-creator |
| "Something is broken", "skill not showing up", "duplicate skills" | Escalate | Hand off to $aweskill-doctor |
First-Time Setup
If aweskill is not installed or the store is not initialized, run the full bootstrap:
- Install the CLI:
npm install -g aweskill - Initialize the central store:
aweskill store init - Confirm the store location:
aweskill store where --verbose - Project built-in skills to the current agent:
aweskill agent add skill aweskill,aweskill-doctor --global --agent <current-agent-id> - Verify:
aweskill agent list --global --agent <current-agent-id>— both skills should show aslinked - Tell the user to invoke skills (
/or$, depending on the agent) and check if the new skills appear. If they do, the skills are ready to use. If not, ask the user to restart the agent.
If aweskill is already installed but the store is not initialized, start from step 2.
If the store is initialized but skills are not projected, start from step 4.
Core Rules
Inspect before mutating:
- Run a read-only inspection command first.
- Confirm scope:
--globalor--project [dir]. - Confirm target agent with
--agentwhen the command touches projections. - Run the mutating command only after the current state is clear.
- Re-run inspection after mutation to verify the result.
For complex changes, also decide:
- Whether the source of truth should remain the central store, a bundle, or an existing agent root.
- Whether the task is single-scope or truly needs both
--globaland--project. - Whether the task is single-agent or should be applied agent-by-agent with explicit
--agent.
Workflows
Source Lifecycle
Use when the task is about searching upstream sources, installing tracked skills, or refreshing them.
# Search upstream providers
aweskill find <query>
aweskill find <query> --local # search local store only
aweskill find <query> -p <provider> # limit to one provider (skills-sh, sciskill, local)
aweskill find <query> -l <number> # limit results (default 10)
aweskill find <query> --domain <domain> # sciskill domain filter
aweskill find <query> --stage <stage> # sciskill stage filter
# Install from GitHub, local path, or sciskill ID
aweskill install <source>
aweskill install <source> --skill <name> # install one skill from a multi-skill source
aweskill install <source> --list # list downloadable skills without installing
aweskill install <source> --all # install all skills from the source
aweskill install <source> --ref <ref> # git branch or tag (GitHub sources only)
aweskill install <source> --as <name> # install under a different name
aweskill install <source> --override # overwrite existing skills
# Check tracked skills for updates
aweskill update --check
aweskill update --check <skill...> # check only the named skills
# Refresh tracked skills
aweskill update [skill...]
aweskill update --source <source> # only update skills from a source
aweskill update --override # discard local changes and overwrite
Decision order:
findwhen the source is not yet known.installwhen the source is known and the skill should enter the central store.update --checkwhen the user wants visibility before change. If the user names specific skills, always pass them (aweskill update --check <skill...>) — never check all tracked skills uninvited.updatewhen the skill is already tracked and should be refreshed. Pass the named skills when the user scoped the request.
Store Work
Use when the task is about existing local skills that need to be brought into or managed inside the central store.
# See what's in the central store
aweskill store list --verbose
# Inspect one managed skill
aweskill store show <skill>
# Scan agent skill directories (dry-run: only discover)
aweskill store scan
aweskill store scan --verbose # show skill names and paths
aweskill store scan --project # scan project scope only
aweskill store scan --agent claude # scan specific agent only
# Scan and import discovered skills
aweskill store scan --import # import all discovered skills (replaces with symlinks)
aweskill store scan --import --override # overwrite existing files
aweskill store scan --import --keep-source # keep originals instead of replacing with symlinks
aweskill store scan --import -
阅读完整来源 ↗