feat: Add build workflow skill for Titan CLI plugins#190
Open
feat: Add build workflow skill for Titan CLI plugins#190
Conversation
Contributor
r-pedraza
commented
Mar 30, 2026
Breaking down the 5,446-line single skill into focused, specialized skills following Anthropic's Progressive Disclosure principle. Skills created: - titan-workflows (885 lines): YAML workflows, hooks, extends - titan-plugin-architecture (655 lines): 5-layer overview - titan-layer-details (841 lines): Deep dive per layer - titan-operations (936 lines): Business logic pattern - titan-testing (1,127 lines): Unit tests, coverage - titan-ui-steps (1,072 lines): Textual TUI, ctx.textual API - titan-antipatterns (1,478 lines): Common mistakes Benefits: - 81% less context loaded on average (999 vs 5,446 lines) - Each skill independently invocable - Better maintainability and composability - Follows Anthropic's skill design best practices Total: 6,994 lines across 7 skills (avg 999 lines/skill) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Following "The Complete Guide to Building Skills for Claude", applied 3 improvements to all 7 specialized skills: 1. Enhanced descriptions with specific trigger phrases - Users can now invoke skills with natural language - Examples: "create workflow", "common mistakes", "test this" 2. Added metadata (author, version) - Follows Anthropic's frontmatter recommendations - Consistent versioning across all skills 3. Added Quick Examples and Troubleshooting sections - 3 real-world scenarios per skill - Common issues with solutions - Improves discoverability and usability Changes per skill: - titan-workflows: +60 lines (examples + troubleshooting) - titan-plugin-architecture: +75 lines - titan-operations: +55 lines - titan-testing: +60 lines - titan-ui-steps: +65 lines - titan-antipatterns: +60 lines - titan-layer-details: +70 lines Total: +445 lines of practical guidance Benefits: - Better skill triggering with natural phrases - Real-world examples help users understand usage - Troubleshooting reduces support burden - Follows Anthropic's Progressive Disclosure principle Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Created a comprehensive meta-skill that teaches Claude how to create new skills following Anthropic's best practices from "The Complete Guide to Building Skills for Claude". Features: - Complete skill creation process (step-by-step) - YAML frontmatter best practices - Progressive Disclosure (3-level system) explained - Trigger phrase patterns and examples - Validation checklist (before finalizing) - Common patterns (tool wrapper, workflow, knowledge) - Real-world examples of skill creation - Troubleshooting common issues The skill includes: - Core Anthropic principles (composability, portability) - Required and optional frontmatter fields - Instructions structure recommendations - 3 Quick Examples showing usage - 3 Troubleshooting scenarios - DO/DON'T best practices summary Use when: User says "create a skill", "new skill", "build a skill", or asks about "skill structure", "skill best practices". This ensures all future skills follow the same high-quality standards we established in this PR. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.