# 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.

## Scripts

### update-skills

Pull latest ClawSkills from git-hangman-lab, then run learn.sh to install/update skills to `{AGENT_WORKSPACE}/skills`.

```bash
claw-skills/scripts/update-skills
```

### promote-improvements

Create and force-push a branch named after the agent (via `ego-mgr get name`) from `{AGENT_WORKSPACE}`.

```bash
claw-skills/scripts/promote-improvements
```

## Workflows

### fix-skills

When a skill or its scripts fail to produce expected results, or throw errors:

> **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.