Skip to content

Update write-skill to discourage over-prescribed output#80

Merged
timctfl merged 1 commit intomainfrom
write-skill-template-updates
Apr 7, 2026
Merged

Update write-skill to discourage over-prescribed output#80
timctfl merged 1 commit intomainfrom
write-skill-template-updates

Conversation

@timctfl
Copy link
Copy Markdown
Owner

@timctfl timctfl commented Apr 7, 2026

Summary

  • Add "not how to reason about it" to the intent-not-scripts guidance
  • Replace rigid turn-by-turn template with loose conversation flow description
  • Add Voice and Approach to the template (was required by text but missing from template)

Test plan

  • Validation passes
  • Write-skill SKILL.md reads coherently with both changes

🤖 Generated with Claude Code

Two changes to reduce how prescriptive the skills it produces will be:

1. Writing style guidance: add "not how to reason about it" to the
   intent-not-scripts principle, so skill authors avoid prescribing
   the agent's internal reasoning process.

2. Template structure: replace rigid named turns and separate analysis
   rubric section with a loose conversation flow description and add
   Voice and Approach to the template (already required by the text
   but was missing from the template).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@timctfl timctfl merged commit 982633a into main Apr 7, 2026
@timctfl timctfl deleted the write-skill-template-updates branch April 8, 2026 01:58
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.

2 participants