lyn/ClawSkills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor: enforce layer responsibilities across all skills

Browse Source 
Rewrote docs/standard.md as the single source of truth for skill
structure (menu/tools/recipes/manual analogy). Trimmed all SKILL.md
files to pure routers, moved recruitment workflow out of SKILL.md
into workflows/recruitment.md, removed duplicated standards from
workflow files.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
zhi
2026-04-17 20:40:16 +00:00
parent fd0f84d6b8
commit 795a710376
9 changed files with 238 additions and 301 deletions
Download Patch File Download Diff File Expand all files Collapse all files

59
claw-skills/SKILL.md
View File

@@ -1,71 +1,34 @@
---
name: claw-skills
description: ClawSkills management and collaboration suite — scripts and workflows for using and improving skills.
description: ClawSkills management — update, improve, create, and fix skills.
---
# claw-skills
ClawSkills management and collaboration suite — scripts and workflows for using and improving skills.
> **All skill-related documentation must be written in English.**
> When creating, improving, or correcting skills, always use English for all documentation, descriptions, and guides.
For additional guidance, see `{baseDir}/docs/standard.md`.
## Skill Structure
A skill is a directory with the following layout:
```
{skill-name}/SKILL.md # Required — skill description and usage
{skill-name}/scripts/ # Optional — executable scripts
{skill-name}/workflows/ # Optional — process guides
{skill-name}/docs/ # Optional — supplementary documentation
```
## Writing Requirements
**SKILL.md should be concise.** It serves as a table of contents for workflows — list each workflow file path with the scenario that triggers it. For supplementary documentation, use `docs/`.
> All skill documentation must be written in English.
## Scripts
### update-skills
Pull latest ClawSkills from git-hangman-lab, then run learn.sh to install/update skills to `{AGENT_WORKSPACE}/skills`.
Pull latest ClawSkills and install/update skills to the agent workspace.
```bash
claw-skills/scripts/update-skills
{baseDir}/scripts/update-skills
```
### promote-improvements
Create and force-push a branch named after the agent (via `ego-mgr get name`) from `{AGENT_WORKSPACE}`.
Create a branch named after the agent and force-push local changes for review.
```bash
claw-skills/scripts/promote-improvements
{baseDir}/scripts/promote-improvements
```
## Workflows
### fix-skills
- `{baseDir}/workflows/create-skills.md` — When you notice a reusable pattern with no existing skill covering it.
- `{baseDir}/workflows/fix-skills.md` — When a skill or its scripts fail or produce unexpected results.
- `{baseDir}/workflows/improve-skills.md` — When a skill has misleading descriptions, missing coverage, or suboptimal behavior.
When a skill or its scripts fail to produce expected results, or throw errors:
## Reference
> **Do not resort to workarounds lightly.**
> Follow `{baseDir}/workflows/fix-skills.md` — identify the root cause first, then fix properly.
### improve-skills
When using a skill and you find:
- Misleading or ambiguous descriptions
- Missing coverage for your use case
- Suboptimal or confusing behavior
> Follow `{baseDir}/workflows/improve-skills.md` to improve it.
### create-skills
When you notice patterns or workflows that could improve efficiency but have no skill covering them:
> Follow `{baseDir}/workflows/create-skills.md` to create a new skill.
- `{baseDir}/docs/standard.md` — Skill structure, layer responsibilities, and writing requirements.