spb/ultra-sharp-agent-skills Public

1<!--2Author: Simon-Pierre Boucher3Contact: contact@spboucher.ai4-->56# doc-skills — Document-Type Skill Collection78**Author:** Simon-Pierre Boucher9**Contact:** contact@spboucher.ai1011Ten ultra-sharp skills, one per document type, each covering **create, read,12and modify** with a single default tool per operation, an explicit escape13hatch, a validation step, and a `references/recipes.md` for deep recipes.14All skills follow the principles in [../RESEARCH-SYNTHESIS.md](../RESEARCH-SYNTHESIS.md)15and pass `python3 ../tools/validate_skills.py`.1617## The collection and its boundaries1819| Skill | Handles | Explicitly does NOT handle |20|---|---|---|21| `processing-xlsx` | .xlsx/.xlsm/.xltx spreadsheets | .csv/.tsv → `processing-csv`; profiling |22| `processing-csv` | .csv/.tsv create/read/edit/convert | quality audits → `profiling-csv-data`; Excel files |23| `processing-docx` | Word .docx/.dotx | PDFs, spreadsheets, Google Docs, Markdown |24| `processing-pptx` | PowerPoint .pptx/.potx | Word docs, PDFs, Google Slides |25| `processing-pdf` | .pdf read/create/merge/split/forms | Word docs, images, Office→PDF export |26| `processing-json` | .json/.jsonl create/read/edit/validate/query | YAML/TOML configs; API design |27| `processing-yaml` | .yaml/.yml incl. configs | JSON files; CI pipeline logic |28| `processing-xml` | .xml create/read/edit/validate/XPath | HTML pages; OOXML internals of Office files |29| `processing-markdown` | .md create/read/edit/convert | release-notes house style; HTML files |30| `processing-html` | .html create/read/extract/edit | live web fetching; XML data files |3132Boundaries are deliberately pairwise-exclusive so that no user request can33plausibly trigger two skills at once — the #1 defense against false-positive34triggering in a large collection.3536## Shared conventions3738- Frontmatter description = WHAT + "Use when …" (literal phrases, extensions) + "Do not use for …"39- One default library per operation; escape hatch named with its install command40- Every write is followed by a re-parse/re-open validation step41- Malformed input → report the parser's error verbatim; never guess or regex-patch42- `SKILL.md` <150 lines; depth lives in `references/recipes.md` (with TOC)43