AI Skill Report Card
Converting Webpages To Skills
YAML--- name: converting-webpages-to-skills description: Converts webpage content into structured Claude Code skill format. Use when you need to transform online documentation, tutorials, or methodologies into reusable skills. ---
Converting Webpages to Skills
Quick Start
Step 1: Scan webpage for main methodology (look for numbered lists, code blocks, step-by-step sections) Step 2: Extract skill name using gerund form of main action (e.g., "testing APIs" → "testing-apis") Step 3: Copy the most actionable example/code snippet for Quick Start section Step 4: Build workflow from the webpage's sequential instructions
Recommendation▾
Remove the code example from Quick Start - this skill is about methodology, not web scraping implementation
Workflow
Progress:
- Identify core methodology (skip intro/background)
- Extract skill name from main action verb
- Copy best code example for Quick Start
- Build numbered workflow from sequential content
- Find 2-3 concrete input/output examples
- Extract specific tips for Best Practices
- Note warnings/errors for Common Pitfalls
Content Extraction Criteria:
- Keep: Code blocks, numbered steps, checklists, specific examples, error messages
- Skip: Company info, navigation, "What is..." sections, marketing copy
- Transform: Prose instructions → numbered lists, examples → input/output format
Recommendation▾
Replace the abstract examples with concrete before/after transformations showing actual webpage content converted to actual skill format
Examples
Example 1: Input: Cypress testing tutorial with login flow
1. Visit login page
2. Type username "user@example.com"
3. Type password "password123"
4. Click submit button
Output:
YAMLname: testing-login-flows Quick Start: cy.visit('/login') cy.get('[data-cy=email]').type('user@example.com')
Example 2:
Input: Docker deployment guide with container setup
Output: Skill with docker run command in Quick Start, 5-step deployment checklist, and port configuration examples
Recommendation▾
Add a clear step-by-step checklist for the actual conversion process with specific criteria for what content to extract vs ignore
Best Practices
- Extract the webpage's most complete code example for Quick Start
- Convert tutorial sections into numbered workflow steps
- Use the webpage's exact variable names and file paths in examples
- Preserve author's specific tool recommendations (don't generalize)
- Extract trigger phrases from headings ("when to use", "best for")
Common Pitfalls
- Don't extract from landing pages without actual methodology
- Skip webpages that are mostly conceptual without concrete steps
- Avoid skills from incomplete tutorials or "coming soon" content
- Don't include company-specific internal processes that won't work elsewhere