How to Create OpenClaw Skills with skill.md

# skill.md has two parts:
# 1. YAML frontmatter (between ---)
# 2. Instructions markdown

---
name: my-skill
version: 1.0.0
description: What this skill does
author: your-name
permissions:
  - filesystem:read
  - network:outbound
triggers:
  - command: /mycommand
  - schedule: "0 9 * * *"
  - webhook: /path
---

## Instructions
Detailed instructions for the AI on how to use this skill.

---
name: weather-reporter
version: 1.0.0
description: "Fetches current weather and provides forecasts using OpenWeatherMap API"
author: "John Doe"
requires: "1.0.0"  # Minimum OpenClaw version
license: "MIT"
homepage: "https://github.com/johndoe/weather-reporter"
---

# Permission categories:
permissions:
  # Filesystem access
  - filesystem:read
  - filesystem:write
  - filesystem:delete
  
  # Network access
  - network:outbound
  - network:inbound
  
  # Shell/process access
  - process:spawn
  - process:kill
  
  # Database access
  - database:read
  - database:write
  
  # System information
  - system:env  # Read environment variables
  - system:info  # CPU, memory, disk info

# Command trigger (manual):
triggers:
  - command: /weather
  - command: /forecast

# Schedule trigger (cron):
triggers:
  - schedule: "0 9 * * 1-5"  # 9 AM weekdays

# Webhook trigger:
triggers:
  - webhook: /update-weather

# Pattern trigger (AI detects pattern):
triggers:
  - pattern: "what's the weather"
  - pattern: "forecast for"

## Instructions

You can fetch weather data and provide forecasts using the OpenWeatherMap API.

### Available Functions

1. **get_current_weather(city, units="metric")**
   - Returns current temperature, humidity, wind speed
   - units: "metric" (Celsius) or "imperial" (Fahrenheit)

2. **get_forecast(city, days=5)**
   - Returns weather forecast for next N days
   - days: 1-14

### Usage Examples

When user asks "What's the weather in London?":
1. Call get_current_weather("London")
2. Format response clearly with temperature, humidity, conditions
3. Offer to provide a forecast

When user asks "5-day forecast for NYC":
1. Call get_forecast("New York", 5)
2. Display each day's forecast in a readable table

// Create scripts/ directory
mkdir scripts

// Create helper functions in scripts/weather.js
export async function getCurrentWeather(city, units = "metric") {
  const response = await fetch(
    `https://api.openweathermap.org/data/2.5/weather?q=${city}&units=${units}&appid=${process.env.OPENWEATHER_API_KEY}`
  );
  return response.json();
}

// Reference in skill.md:
// The system will load helper functions from scripts/ automatically

# Place skill in OpenClaw skills directory
mkdir -p ~/.openclaw/skills/weather-reporter
cp skill.md ~/.openclaw/skills/weather-reporter/
cp -r scripts ~/.openclaw/skills/weather-reporter/

# Restart OpenClaw
npm restart

# In OpenClaw chat, test:
# /weather London
# What's the forecast for NYC?

# Create README.md
cat > README.md << EOF
# Weather Reporter Skill

Fetch current weather and 5-day forecasts using OpenWeatherMap.

## Setup

1. Get API key from openweathermap.org
2. Set OPENWEATHER_API_KEY environment variable
3. Install skill via OpenClaw

## Usage

- "/weather London" - Current weather
- "What's the forecast for NYC?" - 5-day forecast
EOF

# Create clawhub.json with metadata
cat > clawhub.json << EOF
{
  "name": "Weather Reporter",
  "tagline": "Real-time weather and forecasts",
  "description": "Fetches current weather and provides 5-day forecasts using OpenWeatherMap API",
  "category": "productivity",
  "tags": ["weather", "forecast", "api"],
  "pricing": "free"
}
EOF