Skip to content

fix: improve skill optimization workflow precision#148

Merged
shinpr merged 1 commit intomainfrom
feature/improve-skill-optimization
Mar 29, 2026
Merged

fix: improve skill optimization workflow precision#148
shinpr merged 1 commit intomainfrom
feature/improve-skill-optimization

Conversation

@shinpr
Copy link
Copy Markdown
Owner

@shinpr shinpr commented Mar 29, 2026

Summary

  • Wire user phrases and project-specific value into skill-creator description generation as mandatory inputs
  • Make Progressive Disclosure Tier 1 (description quality) a grade gate — Tier 1 failure now blocks grade A/B
  • Replace vague BP-001 "safety-critical/destructive" exception with strict 4-condition AND test + boundary examples
  • Convert "Prohibited Actions" to positive-form "Operational Constraints" (BP-001 self-application)
  • Add skill-creator modification mode for targeted section-level edits with changesSummary output
  • Add WebSearch verification to skill-creator/skill-reviewer for knowledge cutoff protection
  • Add patternExceptions output with per-condition evidence fields
  • Add project-specific value validation (Round 2) and trigger phrase classification to create-skill
  • Extend cross-skill detection to ~/.claude/skills/ in all commands and agents

Test plan

  • Run /create-skill and verify 4-round collection flow (project-specific value in Round 2, phrase classification in Round 3, practical artifacts in Round 4)
  • Verify skill-creator receives user phrases and project-specific value in its input
  • Verify skill-reviewer grades C when description fails Tier 1 quality checklist
  • Verify skill-reviewer outputs patternExceptions (not patternIssues) for legitimate BP-001 exceptions
  • Run /refine-skill and verify it routes through skill-creator modification mode
  • Verify EN/JA parity across all 14 changed files

🤖 Generated with Claude Code

@shinpr shinpr self-assigned this Mar 29, 2026
Skill creation and review had precision gaps: descriptions lacked
project-specific trigger alignment, quality gates were observational,
BP-001 exceptions were vague enough to allow misuse, and the creator
agent had no modification mode for targeted edits.

Key changes:
- Wire user phrases and project-specific value into description generation
- Make Progressive Disclosure Tier 1 a grade gate (blocks A/B on failure)
- Replace BP-001 exception with strict 4-condition AND test + boundary examples
- Convert Prohibited Actions to positive-form Operational Constraints
- Add skill-creator modification mode with changesSummary output
- Add WebSearch verification for knowledge cutoff protection
- Add patternExceptions output with per-condition evidence
- Extend cross-skill detection to ~/.claude/skills/

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@shinpr shinpr force-pushed the feature/improve-skill-optimization branch from 83f1cb5 to 9bcf83a Compare March 29, 2026 13:34
@shinpr shinpr merged commit d3b7dde into main Mar 29, 2026
1 check passed
@shinpr shinpr deleted the feature/improve-skill-optimization branch March 29, 2026 13:36
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