Skip to content

Comments

Refactor commands to skills terminology#66

Merged
nhorton merged 6 commits intomainfrom
refactor/commands-to-skills
Jan 18, 2026
Merged

Refactor commands to skills terminology#66
nhorton merged 6 commits intomainfrom
refactor/commands-to-skills

Conversation

@nhorton
Copy link
Contributor

@nhorton nhorton commented Jan 18, 2026

Summary

  • BREAKING: Refactors "commands" terminology to "skills" throughout the codebase
  • Directory structure changed from .claude/commands/ to .claude/skills/
  • Removed uw. prefix convention, replaced with user-invocable: false frontmatter
  • Version bumped to 0.5.0

Breaking Changes

Before After
.claude/commands/ .claude/skills/
.gemini/commands/ .gemini/skills/
CommandGenerator class SkillGenerator class
CommandLifecycleHook enum SkillLifecycleHook enum
uw.job_name.step_id.md filename job_name.step_id.md with user-invocable: false

Migration Guide

  1. Run deepwork install --platform claude to regenerate skills in the new location
  2. Remove old .claude/commands/ and .gemini/commands/ directories manually
  3. Update any custom code that imports CommandGenerator or CommandLifecycleHook

Test plan

  • All 482 tests pass
  • deepwork install --platform claude creates correct .claude/skills/ structure
  • Non-exposed skills have user-invocable: false in frontmatter
  • Exposed skills do NOT have user-invocable: false
  • Gemini skills directory structure is correct

🤖 Generated with Claude Code

nhorton and others added 4 commits January 18, 2026 12:54
BREAKING CHANGES:
- Directory structure: `.claude/commands/` → `.claude/skills/`
- Directory structure: `.gemini/commands/` → `.gemini/skills/`
- Class renamed: `CommandGenerator` → `SkillGenerator`
- Enum renamed: `CommandLifecycleHook` → `SkillLifecycleHook`
- Removed `uw.` prefix convention for hidden steps
- Hidden steps now use `user-invocable: false` in YAML frontmatter

Changes:
- Renamed all command-related classes, methods, and variables to use "skill"
- Updated templates from command-*.jinja to skill-*.jinja
- Added `user-invocable: false` frontmatter for non-exposed skills
- Updated all tests, documentation, and standard jobs
- Version bumped to 0.5.0

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Streamline template structure with critical guidance upfront
- Simplify descriptions to be concise and search-friendly
- Add explicit step-by-step instructions with clear goals
- Improve section organization (Prerequisites, Inputs, Outputs, Completion)
- Add platform-specific notes (Claude: Skill tool, Gemini: manual invocation)
- Clarify description guidelines in best practices rule file

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
New repo-specific job with three steps:
- test: Pull latest code and run tests until passing
- lint: Run ruff format and check via sub-agent (haiku model)
- commit_and_push: Review changed files with user, then commit and push

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@nhorton nhorton force-pushed the refactor/commands-to-skills branch from ac3b9ba to f9f8beb Compare January 18, 2026 21:54
nhorton and others added 2 commits January 18, 2026 15:11
Claude Code requires skills to be directories containing SKILL.md files
with both 'name' and 'description' fields in frontmatter.

Changes:
- Update ClaudeAdapter to return directory/SKILL.md paths
- Add required 'name' field to Claude skill templates
- Update generator to extract skill names from new path format
- Add SKILL.md validation rule (triggers on **/SKILL.md)
- Update tests to match new structure and template output

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@nhorton nhorton merged commit c02db2a into main Jan 18, 2026
4 checks passed
@nhorton nhorton deleted the refactor/commands-to-skills branch January 18, 2026 22:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant