self-learning

Self-Learning Skill Generator

Autonomously research and learn new technologies from the web, then generate a reusable skill.

Usage

/learn <topic>

If <topic> is missing, show usage. If topic is ambiguous, ask to clarify:

• "react" → "React for web, React Native, or a specific library like react-query?"
• "apollo" → "Apollo GraphQL client, Apollo Server, or Apollo Federation?"
• "aws" → "Which AWS service? (S3, Lambda, DynamoDB, etc.)"

Normalize to kebab-case for filenames.

2. Discover Sources (Web Search)

Use web search tool to find authoritative documentation:

Search queries to try:

1. <topic> official documentation
2. <topic> getting started guide
3. <topic> API reference
4. <topic> GitHub repository

Source prioritization:

1. Official docs sites (e.g., docs.*, *.dev)
2. Official GitHub repositories (README, /docs)
3. Official blogs/announcements

Select 3–5 high-quality URLs maximum.

If no credible sources found, ask user to provide a URL.

---

3. Extract Content (URL Reading)

For each selected URL, read the content:

Extract only relevant sections:

• Installation / setup
• Core concepts
• API reference / key functions
• Common patterns / examples
• Version information

Skip irrelevant content:

• Navigation, ads, login prompts
• Unrelated sidebar content
• Comments, forums

If reading the content fails (JavaScript-heavy sites), fall back to browser agent:

Task: Navigate to <URL> and extract the main content including:
- Installation instructions
- Core concepts and API reference
- Code examples
Return the extracted content as markdown.

Record scrape timestamp for each source (use current date: YYYY-MM-DD format).

---

4. Generate Skill

Skills are modular, self-contained packages. Every skill consists of a required SKILL.md file and optional bundled resources:

skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter metadata (required)
│   │   ├── name: (required)
│   │   └── description: (required)
│   └── Markdown instructions (required)
└── Bundled Resources (optional)
    ├── scripts/          - Executable code (Python/Bash/etc.)
    ├── references/       - Documentation intended to be loaded into context as needed
    └── assets/           - Files used in output (templates, icons, fonts, etc.)