conversation-to-skill-generator
Analyzes conversations to extract patterns and workflows, then generates Skill.md files matching user's style. Use to convert successful chats into reusable skills.
Conversation to Skill Generator
Version: 2.1.0
Last Updated: October 28, 2025
Status: Production Ready
A meta-skill that analyzes existing conversations and generates properly formatted Skill.md files based on identified patterns, workflows, and best practices—while preserving the user's communication style.
When to Use This Skill
Use this skill when you want to:
- Convert a successful conversation into a reusable skill
- Extract workflows and methodologies from completed chats
- Transform one-off solutions into standardized frameworks
- Capture specialized knowledge for future use
- Build a library of domain-specific skills from actual usage patterns
Common trigger phrases:
- "Analyze this conversation and generate a skill"
- "Extract a skill from this completed conversation"
- "Turn our past discussion into a reusable skill"
- "Generate Skill.md from this conversation"
- "Create a skill based on the workflow in this chat"
Prerequisites
Before using this skill, ensure:
- You have access to the conversation (current chat, share link, or copied text)
- The conversation contains a clear workflow, methodology, or pattern worth capturing
- You understand the basic Skill.md format (see
reference/skill-structure-guide.md)
⚠️ CRITICAL: Always read reference/anthropic-best-practices.md before creating any skill to ensure compliance with current standards.
Core Process (5 Steps)
Step 1: Gather Conversation Data
Three input methods:
A. In-Place Analysis (Easiest)
- At the end of your current conversation, say: "Analyze this conversation and generate a skill"
- Claude will analyze the current context
- Best for: Conversations you just completed
B. Share Link (Clean)
- Click "Share" on any conversation → Copy URL
- In a new chat: "Analyze this conversation and create a skill: [URL]"
- Best for: Past conversations or conversations from others
C. Copy-Paste (Fallback)
- Copy full conversation text
- Paste with context: "Here's a conversation I want to turn into a skill: [paste]"
- Best for: When other methods aren't available
Step 2: Read Documentation & Analyze
Critical order - Claude MUST follow:
-
FIRST: Read
reference/anthropic-best-practices.md⚠️- This is NON-NEGOTIABLE
- Ensures generated skill complies with current Anthropic standards
- Reviews format requirements, structure rules, security considerations
-
SECOND: Read
reference/analysis-framework.md- Learn how to analyze conversations comprehensively
- Understand content analysis vs. style analysis
- Apply contextual understanding techniques
-
THIRD: Perform the analysis
- Read entire conversation (all messages from both user and Claude)
- Identify patterns, workflows, tools, and methodologies
- Analyze communication style contextually (not in isolation)
- Determine if workflow is generalizable
For detailed analysis guidance, see: reference/analysis-framework.md
Step 3: Present Summary for Confirmation
After analysis, present a concise summary to the user:
📊 Conversation Analysis Summary:
**Identified Workflow:** [Brief description]
**Key Elements:**
- Main purpose: [...]
- Core methodology: [...]
- Tools/technologies: [...]
- Repeatable patterns: [...]
**Proposed Skill:**
- Name: [suggested-skill-name]
- Description: [what it does + when to use - under 180 chars]
- Structure: [Simple / Advanced with reference files]
**Communication Style:** [Brief note on tone/approach that worked]
---
Does this look correct? Any adjustments needed before I generate the full skill?
Wait for user confirmation before proceeding.
Step 4: Generate Skill Structure
Based on user confirmation, generate the skill using:
For simple skills:
- Use template from
templates/skill-template-simple.md - Single SKILL.md file, self-contained
For complex skills:
- Use template from
templates/skill-template-advanced.md - Create reference files for detailed content
- Organize by domain if multiple areas covered
Quality checks:
- Review
reference/quality-checklist.mdbefore finalizing - ⚠️ Ensure Context Awareness Rule is included in Step 1 of generated skill
- Ensure description is under 180 characters
- Verify YAML frontmatter is correct
- Confirm all file references are one level deep
- Check for consistent terminology
For complete structure guidelines, see: reference/skill-structure-guide.md
Step 5: Present & Iterate
Present the generated skill to the user in a clear format:
# Generated Skill: [skill-name]
[Show complete SKILL.md content]
---
## Additional Files (if applicable)
- reference/[filename].md
- templates/[filename].md
- resources/[filename].md
---
## Next Steps:
1. Review the skill content
2. Request any adjustments
3. Download as ZIP file
4. Upload to Claude.ai (Settings > Capabilities)
5. Test with varied prompts
Would you like me to adjust anything?
Iterate based on user feedback until the skill meets their needs.
Key Principles
When generating skills, always:
-
Follow Anthropic Standards
- Read
reference/anthropic-best-practices.mdfirst - Keep SKILL.md under 500 lines
- Use progressive disclosure for complex content
- Read
-
Prioritize Description Quality
- The description field (max 180 chars recommended) is CRITICAL
- Must include both "what it does" + "when to use it"
- Use specific keywords that trigger activation
-
Include Context Awareness
- Every skill MUST include Context Awareness Rule in Step 1
- This ensures Claude reads full conversation history before acting
- Prevents ignoring user's earlier messages or context
- Critical for maintaining continuity in conversations
-
Understand Style Contextually
- Analyze conversation dynamics, not isolated messages
- Match the successful communication pattern that emerged
- Balance user's voice with clarity (don't sacrifice usability)
-
Create Evaluation Scenarios
- Before extensive documentation, create 3 test scenarios
- See
resources/evaluation-scenarios.mdfor examples - Test the skill with varied prompts after creation
-
Collaborate with User
- Present draft, get feedback, iterate
- Make skills feel personalized and relevant
- Ensure clarity and usability
File Organization
This skill uses progressive disclosure:
- SKILL.md (this file) - High-level guide with core process
- reference/ - Detailed guides loaded when needed
analysis-framework.md- How to analyze conversationsanthropic-best-practices.md- Anthropic's official guidelinesskill-structure-guide.md- Complete structure referencequality-checklist.md- Pre-creation validation
- templates/ - Ready-to-use templates
skill-template-simple.md- Basic templateskill-template-advanced.md- Complex template with references
- resources/ - Additional materials
evaluation-scenarios.md- Test casescommon-triggers.md- Activation phrasesexternal-links.md- Official documentation links
Troubleshooting
Skill doesn't activate when expected:
- Check description includes clear trigger keywords
- Ensure skill is toggled ON in Settings > Capabilities
- Try more explicit trigger phrases
- Review Claude's thinking to see activation logic
Generated skill is too complex:
- Split into multiple focused skills
- Use reference files for detailed content
- Keep SKILL.md under 500 lines
Style doesn't match user preferences:
- Re-analyze conversation with focus on successful exchanges
- Ask user for explicit style preferences
- Iterate based on feedback
For comprehensive troubleshooting, see official resources in resources/external-links.md
Meta Note
This skill is itself an example of what it creates—it was generated through the process it describes!
Remember: A good skill doesn't just capture a workflow—it captures it in a way that's clear, usable, and feels natural to the person who will use it.
Quick Reference
Before creating: Read reference/anthropic-best-practices.md
During analysis: Follow reference/analysis-framework.md
For structure: Check reference/skill-structure-guide.md
Before finalizing: Review reference/quality-checklist.md
For testing: Use scenarios from resources/evaluation-scenarios.md