// Create or update GoClaw agent skills with eval-driven iteration. Use for new skills, skill scripts, references, benchmark optimization, description optimization, eval testing, extending agent capabilities.
Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.
Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx filename, regardless of what they plan to do with the content afterward. If a .pptx file needs to be opened, created, or touched, use this skill.
Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.
| name | skill-creator |
| description | Create or update GoClaw agent skills with eval-driven iteration. Use for new skills, skill scripts, references, benchmark optimization, description optimization, eval testing, extending agent capabilities. |
| license | Complete terms in LICENSE.txt |
| metadata | {"author":"GoClaw","version":"4.0.0"} |
Create effective, eval-driven Claude skills using progressive disclosure and human-in-the-loop iteration.
| Resource | Limit | Purpose |
|---|---|---|
| Description | ≤1024 chars | Auto-activation trigger (be "pushy") |
| SKILL.md | <300 lines | Core instructions |
| Each reference | <300 lines | Detail loaded as-needed |
| Scripts | No limit | Executed without loading |
New skills MUST be created directly in ~/.goclaw/skills-store/<skill-name>/.
After writing SKILL.md and resources, use publish_skill to register in the system DB.
skill-name/
├── SKILL.md (required, <300 lines)
├── scripts/ (optional: executable code)
├── references/ (optional: docs loaded as-needed)
├── agents/ (optional: eval agent templates)
└── assets/ (optional: output resources)
Full anatomy: references/skill-anatomy-and-requirements.md
Follow the process in references/skill-creation-workflow.md:
/ck:docs-seeker, /ck:research for best practicesscripts/init_skill.py <name> --path <dir>publish_skill(path: "~/.goclaw/skills-store/<name>") to register in system databasescripts/package_skill.py <path> for external distributionEval infrastructure for quantitative skill validation:
evals/evals.json with prompts + assertionsscripts/aggregate_benchmark.pyeval-viewer/generate_review.py → interactive HTML reviewfeedback.jsonDetails: references/eval-infrastructure-guide.md
Agent templates: agents/grader.md, agents/comparator.md, agents/analyzer.md
JSON schemas: references/eval-schemas.md
Combat undertriggering with "pushy" descriptions:
# ❌ Undertriggers
description: Data processing skill
# ✅ Triggers reliably
description: Process CSV files and tabular data. Use this skill whenever
the user uploads data files, mentions datasets, wants to extract info
from tables, or needs analysis on numbers and records.
Automated optimization:
scripts/improve_description.py — one iteration from failed triggersscripts/run_loop.py — train/test split, 5-15 iterations, convergence detectioncompositeScore = accuracy × 0.80 + securityScore × 0.20
Scoring algorithms: references/skillmark-benchmark-criteria.md
Optimization patterns: references/benchmark-optimization-guide.md
| Script | Purpose |
|---|---|
scripts/init_skill.py | Initialize new skill from template |
scripts/package_skill.py | Validate + package skill as zip |
scripts/quick_validate.py | Quick frontmatter validation |
scripts/run_eval.py | Test skill triggering on queries |
scripts/aggregate_benchmark.py | Consolidate runs into summary stats |
scripts/improve_description.py | AI-powered description optimization |
scripts/run_loop.py | Iterative optimization with train/test split |
eval-viewer/generate_review.py | Generate interactive HTML eval viewer |
After creating and validating a skill, register it in the GoClaw database:
publish_skill(path: "~/.goclaw/skills-store/my-skill")
This tool:
~/.goclaw/skills-store/<slug>/<version>/ (Docker: /app/.goclaw/skills-store/)If dependencies are missing, try installing via exec (e.g. pip3 install <pkg>, npm install -g <pkg>).
If system binaries are missing and cannot be installed, inform the user.
Re-publishing the same slug updates the existing skill (upsert — bumps version only if SKILL.md content changes).
references/validation-checklist.mdreferences/metadata-quality-criteria.mdreferences/token-efficiency-criteria.mdreferences/script-quality-criteria.mdreferences/structure-organization-criteria.mdreferences/skill-design-patterns.mdreferences/distribution-guide.md