AI Skill Generator

Generate comprehensive SKILL.md files from multiple web sources

Transform any topic into a comprehensive learning guide by automatically discovering, scraping, and synthesizing content from documentation, GitHub, StackOverflow, and blogs.

Diagram

🎯 Topic

🔍 Discover

📥 Scrape

✨ Synthesize

📄 SKILL.md

Quick Start

CLI

bash
praisonai recipe run ai-skill-generator \
  --var topic="react hooks"

Python

python
from praisonai import recipe

result = recipe.run(
    "ai-skill-generator",
    input={"topic": "kubernetes pods"}
)
print(result.output)

How It Works

  1. Source Discovery

    AI-powered search finds 8 relevant URLs: – 2 documentation sources – 2 GitHub repositories – 2 StackOverflow Q&As – 2 blog tutorials

  2. Parallel Scraping

    All 8 sources scraped simultaneously with type-specific extraction: – Docs → API references, examples – GitHub → Code patterns, implementations – StackOverflow → Problems, solutions – Blogs → Tutorials, explanations

  3. AI Synthesis

    Content combined into SKILL.md format: – Quick Start – Core Concepts – Essential Patterns – Common Pitfalls

Source Types

Diagram

8 Sources (2 each)

📚 Docs

💻 GitHub

❓ StackOverflow

📝 Blogs

API Reference

Official Examples

Code Patterns

Implementations

Common Problems

Best Solutions

Tutorials

Deep Dives

Agents

Output Format

The generated SKILL-{topic}.md follows Anthropic’s format:

Quick Start

Get up and running in minutes with installation commands and basic examples.

Core Concepts

Essential knowledge everyone needs to understand the topic.

Essential Patterns

Common usage patterns with working code examples.

Common Pitfalls

Mistakes to avoid and how to fix them.

Configuration

topic string

The topic to generate a skill guide for.

Examples: "react hooks", "kubernetes pods", "python decorators"

sources_per_type integer

Number of sources to find per type (docs, github, stackoverflow, blog).

max_workers integer

Maximum parallel scraping workers.

Requirements

Environment Variables
bash
export OPENAI_API_KEY="sk-..."
Dependencies

The recipe uses built-in tools from praisonaiagents: – search_web – Multi-provider search – web_crawl – Content extraction

No additional packages required.

Example Output

Running with topic="react hooks" produces:

markdown
# React Hooks

> A comprehensive skill guide for React Hooks

---

## Quick Start

```bash
npm install react
jsx
import { useState, useEffect } from 'react';

function Counter() {
  const [count, setCount] = useState(0);
  return <button onClick={() => setCount(count + 1)}>{count}</button>;
}

Core Concepts

Hooks let you use state and other React features without writing a class…


Essential Patterns

useState Pattern

jsx
const [state, setState] = useState(initialValue);

useEffect Pattern

jsx
useEffect(() => {
  // Side effect
  return () => { /* cleanup */ };
}, [dependencies]);

Common Pitfalls

❌ Don’t call hooks conditionally

jsx
// Wrong
if (condition) {
  const [state, setState] = useState();
}

✅ Always call at top level

jsx
// Correct
const [state, setState] = useState();
if (condition) {
  // use state here
}

Pipeline Details

StageAgentToolOutput
Discoversource_finderidentify_sources8 URLs
Scrapescraper (×8)scrape_sourceContent
Synthesizesynthesizer—SKILL.md

Custom Tools

The recipe includes these custom tools in tools.py:

ToolSignatureDescription
identify_sources(topic: str) -> List[Dict]Find 8 URLs (2 per source type)
scrape_source(url: str, source_type: str) -> DictScrape with type-specific extraction
format_skill_md(content: Dict) -> strFormat as SKILL.md

Related Recipes