class SkillsLoader:
    """
    Loader for agent skills.

    Skills are markdown files (SKILL.md) that teach the agent how to use
    specific tools or perform certain tasks.
    """

workspace/
└── skills/
    ├── web-research/
    │   ├── SKILL.md          # Skill instructions
    │   ├── templates/        # Optional templates
    │   └── scripts/          # Optional helper scripts
    ├── python-dev/
    │   └── SKILL.md
    └── data-analysis/
        └── SKILL.md

---
title: Web Research
description: Search and extract information from the web
metadata: |
  {
    "nanobot": {
      "always": false,
      "requires": {
        "env": ["BRAVE_API_KEY"]
      }
    }
  }
---

# Web Research Skill

This skill teaches you how to perform effective web research using the 
`web_search` and `web_fetch` tools.

## When to Use

Use this skill when you need to:
- Find current information not in your training data
- Research specific topics or questions
- Verify facts or claims
- Gather data from multiple sources

## Tools

### web_search

Searches the web and returns titles, URLs, and snippets.

**Parameters:**
- `query` (string, required): The search query
- `count` (integer, optional): Number of results (1-10, default: 5)

### web_fetch

Fetches a URL and extracts readable content.

**Parameters:**
- `url` (string, required): The URL to fetch
- `extractMode` (string, optional): "markdown" or "text" (default: "markdown")
- `maxChars` (integer, optional): Maximum characters to return

## Workflow

1. Use `web_search` to find relevant sources
2. Review the search results and identify the most promising URLs
3. Use `web_fetch` to extract content from selected URLs
4. Synthesize information from multiple sources
5. Cite your sources when providing information

## Example

```json
// Search for information
{"tool": "web_search", "query": "latest developments in quantum computing"}

// Fetch specific article
{"tool": "web_fetch", "url": "https://example.com/quantum-news"}

from nanobot.agent.skills import SkillsLoader
from pathlib import Path

loader = SkillsLoader(workspace=Path("/path/to/workspace"))
skills = loader.list_skills(filter_unavailable=True)

for skill in skills:
    print(f"{skill['name']}: {skill['path']} ({skill['source']})")

web-research: /workspace/skills/web-research/SKILL.md (workspace)
python-dev: /nanobot/skills/python-dev/SKILL.md (builtin)

content = loader.load_skill("web-research")
if content:
    print(content)
else:
    print("Skill not found")

summary = loader.build_skills_summary()

<skills>
  <skill available="true">
    <name>web-research</name>
    <description>Search and extract information from the web</description>
    <location>/workspace/skills/web-research/SKILL.md</location>
  </skill>
  <skill available="false">
    <name>docker-ops</name>
    <description>Manage Docker containers and images</description>
    <location>/nanobot/skills/docker-ops/SKILL.md</location>
    <requires>CLI: docker</requires>
  </skill>
</skills>

skills_summary = self.skills.build_skills_summary()
if skills_summary:
    parts.append(f"""# Skills

The following skills extend your capabilities. To use a skill, read its SKILL.md file using the read_file tool.
Skills with available="false" need dependencies installed first - you can try installing them with apt/brew.

{skills_summary}""")

def build_system_prompt(self, skill_names: list[str] | None = None) -> str:
    # ... identity and bootstrap ...
    
    always_skills = self.skills.get_always_skills()
    if always_skills:
        always_content = self.skills.load_skills_for_context(always_skills)
        if always_content:
            parts.append(f"# Active Skills\n\n{always_content}")

def _check_requirements(self, skill_meta: dict) -> bool:
    """Check if skill requirements are met (bins, env vars)."""
    requires = skill_meta.get("requires", {})
    for b in requires.get("bins", []):
        if not shutil.which(b):
            return False
    for env in requires.get("env", []):
        if not os.environ.get(env):
            return False
    return True

# Search for skills
nanobot skill search "web scraping"

# Install a skill
nanobot skill install username/skill-name

# List installed skills
nanobot skill list