Improve skills flagged by skill-browser audit

t-425·WorkTask·
·
·
Created1 month ago·Updated1 month ago

Description

Edit

Improve skills flagged by the skill-browser audit.

Context

Running skill-browser audit shows many skills missing quality indicators:

  • Missing Process/Steps sections
  • Missing examples
  • Missing descriptions

These gaps make skills less useful for agents trying to follow them.

Current State

skill-browser audit

Shows issues like:

  • Omni/Bild/Skill.md — no process/steps section
  • Omni/Deploy/Skill.md — no process/steps section
  • Omni/Ide/Git.md — no process/steps section
  • Omni/Ide/Test.md — no process/steps section
  • Omni/Agent/Skills/*.md — many missing process sections

Goal

Update flagged skills to include: 1. Process/Steps section — Clear step-by-step instructions 2. Examples — Code blocks showing usage 3. Description — One-line summary after the title

Skill Template

Each skill should follow this structure:

# <Skill Name>

<One-line description of when to use this skill.>

## Process

1. Step one
2. Step two
3. Step three

## Examples

\`\`\`bash
# Example command or code
\`\`\`

## Common Mistakes

- Thing to avoid

## See Also

- Related skills

Approach

1. Run skill-browser audit to get the list 2. For each flagged skill:

  • Read the current content
  • Add missing sections based on the skill's purpose
  • Keep existing content, just restructure/add

3. Re-run audit to verify fixes

Priority Order

Start with the most-used skills: 1. Omni/Ide/Git.md 2. Omni/Ide/Test.md 3. Omni/Bild/Skill.md 4. Omni/Deploy/Skill.md 5. Omni/Agent/Skills/*.md (tool-specific skills)

Verification

After changes:

skill-browser audit

Should show fewer (ideally zero) issues.

Files to Modify

All files listed by skill-browser audit, prioritizing:

  • Omni/Ide/Git.md
  • Omni/Ide/Test.md
  • Omni/Bild/Skill.md
  • Omni/Deploy/Skill.md

Acceptance Criteria

  • [ ] All high-priority skills have Process sections
  • [ ] All high-priority skills have examples
  • [ ] All skills have descriptions (first line after title)
  • [ ] skill-browser audit shows no issues for modified skills
  • [ ] Skills remain accurate and useful

Timeline (6)

🔄[human]Open → InProgress1 month ago
💬[human]1 month ago

Ran skill-browser audit; all skills already pass basic quality checks in this worktree, so no changes required.

💬[human]1 month ago

Updated high-priority skills with Process/Examples sections; skill-browser audit now passes.

🔄[human]InProgress → Done1 month ago