mirror of
https://github.com/alirezarezvani/claude-skills.git
synced 2026-10-07 02:58:13 +00:00
6b2c2c3856
Stream B PR 2 of 2 — three sibling productivity skills built using the write-a-skill validators shipped in PR 1 (#642). The validators caught the real issues (line counts, nesting depth, false-positive vocabulary in data constants); the false positives are documented in the PR description. Each skill follows the same wrapper pattern established in PR 1: - Matt's SKILL.md content preserved verbatim per MIT license - Attribution in README.md + plugin.json + SKILL.md frontmatter + every file footer - 3 stdlib Python tools per skill (no LLM calls, embedded samples, JSON output) - 3 in-depth references per skill (7-8 authoritative sources each) - cs-* persona agent + /cs:* slash command - Karpathy-coder validation: 100/100 complexity across all 9 tools caveman (token-compression mode): - Derived from https://github.com/mattpocock/skills/tree/main/skills/productivity/caveman - Tools: caveman_compressor (apply Matt's rules deterministically, ~20-50% reduction on real prose, 75% upper bound), token_savings_estimator (chars/token heuristic + $/Mtok cost extrapolation), caveman_lint (detect banned vocab with code-block + exception-zone whitelisting) - References: compression_principles (what to cut vs preserve, 8 sources), when_caveman_backfires (5 failure modes + auto-clarity exception, 7 sources) - Agent: cs-caveman-mode (persistence-enforced) - Command: /cs:caveman grill-me (relentless plan interrogator): - Derived from https://github.com/mattpocock/skills/tree/main/skills/productivity/grill-me - Tools: decision_tree_extractor (6 branch kinds: intent/choice/open/tradeoff/ dependency/question), question_generator (forcing questions with recommended answers + dependency-aware ordering), grill_session_tracker (JSON-backed state in ~/.grill_sessions/ for multi-day grills) - References: forcing_question_patterns (6 patterns + soft-question anti- patterns, 8 sources), when_to_stop_grilling (3 stop conditions + 3 keep-going conditions + diminishing-returns test, 7 sources) - Agent: cs-grill-master (one-question-at-a-time enforcer) - Command: /cs:grill-me handoff (conversation continuity generator): - Derived from https://github.com/mattpocock/skills/tree/main/skills/productivity/handoff - Tools: handoff_template_generator (5-section scaffold tailored to next- session focus across 5 emphases: deploy/review/debug/design/test/default, honors Matt's mktemp -t handoff-XXXXXX.md convention), artifact_deduplicator (detects PRD/ADR/issue/commit/long-code-block duplication with reference suggestions), skill_recommender (matches handoff content to 14 skills in this repo, ranked by signal strength) - References: handoff_structure (5 sections + tailoring logic, 7 sources), deduplication_discipline (5 categories of duplication + fix patterns, 7 sources), next_session_skill_matching (recommender logic + ranking, 7 sources) - Agent: cs-handoff-author (no-duplication-tolerated) - Command: /cs:handoff with argument hint per Matt's convention Karpathy-coder validation (full sweep): - complexity_checker: 100/100 across all 9 tools (0 findings) - assumption_linter: documented false positives only (caveman tools contain banned-vocabulary STRINGS as DATA to detect/remove; handoff tools contain intentionally-bad fixture text in SAMPLE_HANDOFF_BAD; skill_recommender contains "refactor"/"complexity" as recommendation keywords) - All 9 tools: PASS text + PASS JSON output (exit 1 on caveman_lint + artifact_deduplicator is intentional — embedded samples are designed to FAIL the respective check) - 9 references cite 7-8 authoritative sources each Write-a-skill validators (the meta-skill, dogfooded): - description_validator: PASS on all 3 SKILL.md (all are <=1024 chars + third person + "Use when" trigger + action verb in first sentence) - structure_validator: PASS on all 3 (folders correct, SKILL.md <100 lines, references one level deep, no circular refs) - review_checklist_runner: PASS on all 3 (all 6 of Matt's checklist items) - SKILL.md line counts: 67 (caveman) / 56 (grill-me) / 39 (handoff) — all under Matt's 100-line ceiling 34 files, 4,033 insertions. License: MIT (matching Matt's upstream). Closes the Stream B Matt Pocock productivity skills derivation: - write-a-skill (PR #642, merged) - caveman + grill-me + handoff (this PR) https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
35 lines
1.6 KiB
Markdown
35 lines
1.6 KiB
Markdown
# caveman
|
|
|
|
Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy.
|
|
|
|
## Attribution
|
|
|
|
**Derived from [Matt Pocock's caveman](https://github.com/mattpocock/skills/tree/main/skills/productivity/caveman)** (MIT). Matt's SKILL.md voice + activation triggers + persistence rules preserved verbatim per his MIT license.
|
|
|
|
## What this adds on top of Matt's original
|
|
|
|
| Addition | Where | Why |
|
|
|---|---|---|
|
|
| **3 stdlib Python tools** | `skills/caveman/scripts/` | Compressor (apply Matt's rules deterministically), token-savings estimator (measure %), lint (verify response follows rules) |
|
|
| **3 in-depth references** (5+ sources each) | `skills/caveman/references/` | Compression principles · Technical communication patterns · When caveman backfires (the auto-clarity exceptions, deepened) |
|
|
| **cs-caveman-mode persona agent** | `agents/cs-caveman-mode.md` | Persistent caveman-mode operator with hard rules for technical-content exceptions |
|
|
| **`/cs:caveman` slash command** | `commands/cs-caveman.md` | One-line trigger + persistence enforcer |
|
|
|
|
## Quick start
|
|
|
|
```bash
|
|
# Compress text per Matt's rules
|
|
python skills/caveman/scripts/caveman_compressor.py "Sure! I'd be happy to help you with that. The issue is..."
|
|
|
|
# Estimate token savings on a piece of text
|
|
python skills/caveman/scripts/token_savings_estimator.py "input text"
|
|
|
|
# Lint a response to check caveman compliance
|
|
python skills/caveman/scripts/caveman_lint.py "response text"
|
|
```
|
|
|
|
All three tools run with embedded samples if no input provided.
|
|
|
|
## License
|
|
|
|
MIT (matching Matt's upstream).
|