Skip to content

feat(skill-creator): Add skill synthesis guide and upstream best practices#52

Merged
dcramer merged 2 commits intomainfrom
docs/skill-synthesis-guide
Feb 18, 2026
Merged

feat(skill-creator): Add skill synthesis guide and upstream best practices#52
dcramer merged 2 commits intomainfrom
docs/skill-synthesis-guide

Conversation

@dcramer
Copy link
Member

@dcramer dcramer commented Feb 18, 2026

Improve the skill-creator by synthesizing patterns from upstream implementations
(Anthropic's and OpenAI's skill-creators, the Agent Skills spec, best practices
docs) and document the research workflow so others can repeat it.

skill-creator improvements:

  • Add planning step before writing (analyze use cases → identify scripts/references/assets)
  • Add description guidelines (third person, trigger phrases, pattern template)
  • Add validation script (quick_validate.py) for catching frontmatter/structure issues
  • Add reference docs for Claude Code extensions, workflow patterns, and output patterns
  • Expand anti-patterns (trigger info in body, extraneous files, missing navigation)

Skill synthesis guide (docs/skill-synthesis.md):

  • Documents the agent-driven workflow: research upstream → review findings → create with skill-creator
  • Lists key sources to point your agent at (spec, Anthropic/OpenAI repos, best practices)
  • Linked from README References section

dcramer and others added 2 commits February 18, 2026 03:42
…eator

Research and incorporate patterns from Anthropic's and OpenAI's
skill-creators, the Agent Skills spec, and best practices docs.
Adds planning step, description guidelines, validation script,
Claude Code extension docs, workflow/output patterns, and
expanded anti-patterns.

Co-Authored-By: Claude <noreply@anthropic.com>
Document the agent-driven workflow for researching upstream
implementations and best practices when creating new skills.
Pairs with the skill-creator skill — synthesis handles research,
skill-creator handles implementation.

Co-Authored-By: Claude <noreply@anthropic.com>
@dcramer dcramer marked this pull request as ready for review February 18, 2026 11:47
@dcramer dcramer merged commit 8ac472a into main Feb 18, 2026
10 checks passed
@dcramer dcramer deleted the docs/skill-synthesis-guide branch February 18, 2026 11:55
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

Comments