Self-Learning Skill Generator

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

Usage

``` /learn ```

If `` 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. ` official documentation` 2. ` getting started guide` 3. ` API reference` 4. ` 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 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.) ```

1. Read `references/skill_creation_guide.md` to understand the format and principles. 2. Synthesize the learned and extracted information into a new skill. - Trigger: Write a description that clearly defines when to use it. - Workflow: Create step-by-step instructions. - Format: Ensure valid YAML frontmatter and proper file structure.

5. Save the Skill

Antigravity supports two types of skills, save a global-workspace if asked.

`.agent/skills//` Workspace-specific

`~/.gemini/antigravity/skills//` Global (all workspaces)

Create directory if it doesn't exist, warn user before overwriting existing skill.

---

6. Confirm to User

Report: ``` ✓ Created skill: Sources scraped: Saved to: .agent/skills//SKILL.md This skill will auto-trigger when working with . ```

---

Tool Reference

`search_web`: Discover documentation URLs

`read_url_content`: Extract content from static pages

`browser_subagent`: Extract content from JavaScript-heavy sites

`write_to_file`: Save the generated skill

Critical Rules

1. Never hallucinate documentation: Only include information from scraped sources. 2. Never invent APIs: If documentation is unclear, ask the user what to do. 3. Ask for URLs: If automated discovery fails, ask user for specific URLs. 4. Verify sources: Prefer official sources over third-party tutorials.