Commit graph

156 commits

Author SHA1 Message Date
dan 8414ca773c docs(tufte-press): add clear invocation instructions for users
- Add Quick Start section with simple trigger phrase examples
- Add detailed 'How to Invoke This Skill' section explaining:
  - Natural language trigger phrases
  - Conversation-based card generation
  - Detail specification (pages, depth, content preferences)
  - What the agent understands and how it responds

Makes it clear to users they just need to ask naturally:
'Create a study card about [topic]' - no special commands needed.
2025-11-10 15:08:58 -08:00
dan 819ec78b33 docs(worklog): update with guardrails commit 2025-11-10 15:06:17 -08:00
dan df02264c3f docs(tufte-press): add guardrails and self-check rubric to agent instructions
- Add guardrails for under-specified requests (scaffold with clarifications)
- Add self-check rubric for content quality validation
- Ensures agent validates accuracy, clarity, annotation utility, balance, and print suitability
- Matches tufte-press project's latest LLM authoring prompt

These sections guide the agent to produce high-quality educational content
and handle unclear requests gracefully by asking for clarification.
2025-11-10 15:05:54 -08:00
dan ec8dba8097 docs(worklog): update commit count for tufte-press evolution session 2025-11-10 15:03:57 -08:00
dan 5fea49b7c0 feat(tufte-press): evolve skill to complete workflow with JSON generation and build automation
- Transform tufte-press from reference guide to conversation-aware generator
- Add JSON generation from conversation context following strict schema
- Create build automation scripts with Nix environment handling
- Integrate CUPS printing with duplex support
- Add comprehensive workflow documentation

Scripts added:
- skills/tufte-press/scripts/generate-and-build.sh (242 lines)
- skills/tufte-press/scripts/build-card.sh (23 lines)

Documentation:
- Updated SKILL.md with complete workflow instructions (370 lines)
- Updated README.md with usage examples (340 lines)
- Created SKILL-DEVELOPMENT-STRATEGY-tufte-press.md (450 lines)
- Added worklog: 2025-11-10-tufte-press-skill-evolution.org

Features:
- Agent generates valid JSON from conversation
- Schema validation before build (catches errors early)
- Automatic Nix shell entry for dependencies
- PDF build via tufte-press toolchain
- Optional print with duplex support
- Self-contained margin notes enforced
- Complete end-to-end testing

Workflow: Conversation → JSON → Validate → Build → Print

Related: niri-window-capture, screenshot-latest, worklog skills
2025-11-10 15:03:44 -08:00
dan d8c2e92f0a Initial commit: Agentic coding skills repository
- Add comprehensive documentation (README, WORKFLOW, DEPLOYMENT)
- Add skill template for creating new skills
- Port worklog skill from dotfiles (org-mode session documentation)
- Port update-spec-kit skill from dotfiles (ecosystem updates)
- Include spec-kit framework for structured development
- Add OpenCode commands for spec-kit workflow integration

Repository provides unified skill development for both Claude Code and OpenCode agents.
2025-11-08 10:55:15 -08:00