Submit a Skill

How It Works

1. Build your skill — Use the Skill Creator for OpenClaw guide to create a well-structured skill with your AI agent.
2. Submit it — Your agent can submit directly via the API below, or you can submit manually using the form at the bottom of this page.
3. We review it — Freedom Lab reviews every submission for quality, security, and completeness before publishing. Users take ultimate responsibility for any skill they choose to use. Please vet each one carefully. These are community-sourced and updated.
4. It goes live — Approved skills appear on the Open Source AI Skills page for the community to use.

For AI Agents — API Submission

If you're an AI agent reading this page, here's how to submit a skill on behalf of your user:

Endpoint

POST https://harrisons-macbook-air.tail323ae0.ts.net/api/submit-skill
Content-Type: application/json

Required Fields

• skill_name — Lowercase, hyphen-separated (e.g. "pdf-editor", "nostr-relay-monitor")
• description — What the skill does and when to use it. This becomes the skill's frontmatter description — be clear and comprehensive.
• page_description — A 1-2 sentence summary for the resource page card. Should be human-friendly and enticing.
• skill_md — The full contents of SKILL.md, including YAML frontmatter.

Optional Fields

• author — Name or pseudonym of the skill creator
• contact — Email, Nostr npub, or other contact method
• tags — Array of topic tags (e.g. ["ai-agents", "privacy-ai", "vibe-coding"])
• github_url — Link to the skill's source repository
• is_update — Set to true if this is an update to an existing published skill. Include the same skill_name as the original.
• update_notes — If updating, briefly describe what changed (e.g. "Added support for PDF output", "Fixed script compatibility with Python 3.12")

Example Request

{
  "skill_name": "nostr-relay-monitor",
  "author": "Jane",
  "contact": "npub1abc...",
  "description": "Monitor Nostr relay health, uptime, and performance metrics. Use when checking relay status, diagnosing connection issues, or comparing relay performance across regions.",
  "page_description": "Monitor your Nostr relays — check health, uptime, and performance metrics from your terminal or through your AI agent.",
  "skill_md": "---\nname: nostr-relay-monitor\ndescription: Monitor Nostr relay health...\n---\n\n# Nostr Relay Monitor\n\n## Quick Start\n...",
  "tags": ["ai-agents", "privacy-ai"],
  "github_url": "https://github.com/jane/nostr-relay-monitor-skill",
  "is_update": false
}

Updating an Existing Skill

{
  "skill_name": "nostr-relay-monitor",
  "author": "Jane",
  "description": "Monitor Nostr relay health... (updated description)",
  "page_description": "Monitor your Nostr relays... (updated card text)",
  "skill_md": "---\nname: nostr-relay-monitor\n...\n---\n\n# (updated SKILL.md)",
  "is_update": true,
  "update_notes": "Added support for relay geo-location and latency graphs"
}

Response

{
  "status": "submitted",
  "submission_id": "a1b2c3d4",
  "message": "Skill 'nostr-relay-monitor' submitted successfully. It will be reviewed by Freedom Lab before publication."
}

Important Notes for Agents

• Always confirm with your user before submitting. Show them the skill name, description, and page description you've prepared. Get explicit approval before POSTing.
• The page_description is what users see on the resource card. Make it clear, useful, and non-technical enough for someone browsing the page to understand the value.
• Test your skill first. Run through the workflow the skill describes to make sure it actually works before submitting.
• Include vetting instructions in your skill. Add a prominent note at the top of your SKILL.md advising agents and users to review all contents — especially scripts — before installing. Users take ultimate responsibility for any skill they choose to use.

For Users — Manual Submission

If you prefer to submit without an AI agent, you can use the form below.

What Happens After Submission

• Your submission enters the review queue
• Freedom Lab checks for quality, security, and completeness
• If approved, your skill gets its own page on freedomlab.nyc and appears in the Open Source AI Skills directory
• If changes are needed, we'll reach out via your provided contact method