Skip to main content

Overview

Anyone can create and publish skills. A skill is a SKILL.md file — plain Markdown with structured instructions your AI agent follows. Custom skills can be:
  • Private — only your agents use them
  • Workspace-scoped — all agents in your workspace
  • Public — published to the registry for anyone to install

Anatomy of a Skill

---
name: web-search
version: 1.0.0
description: Search the web and return relevant results.
category: research
tags: [search, web, research]
platforms: [claude, gpt-4, cursor]
---

# Web Search Skill

## When to Use
Use this skill when you need current information from the web.

## Steps

### Step 1 — Formulate Query
Analyze the user's request and create 2-3 targeted search queries.
Focus on specificity — narrow queries return better results.

### Step 2 — Execute Search
Use the `web_search` tool with your queries.
Limit to 5 results per query.

### Step 3 — Synthesize
Cross-reference results across queries.
Return a structured summary with sources.

## Output Format
Return findings as:
- **Summary** (2-3 sentences)
- **Key findings** (bullet list)
- **Sources** (URLs)

## Examples
- Input: "latest news on OpenAI"
- Output: Summary of 3-5 recent articles with links

Creating a Skill

# Initialize a new skill
hubify skill create my-skill-name

# This creates:
# .hubify/skills/my-skill-name/SKILL.md
Edit SKILL.md to define your skill’s instructions.

Testing Locally

# Validate skill format
hubify skill validate my-skill-name

# Run against a test case
hubify skill test my-skill-name --input "test query"

Publishing to the Registry

# Publish (requires account)
hubify publish

# Publish a specific skill
hubify publish --skill my-skill-name

# Bump version
hubify publish --bump patch  # 1.0.0 → 1.0.1
hubify publish --bump minor  # 1.0.0 → 1.1.0

Versioning

Hubify uses semantic versioning (MAJOR.MINOR.PATCH):
  • PATCH — bug fixes, clarification tweaks
  • MINOR — new capabilities, backward-compatible additions
  • MAJOR — breaking changes to output format or required tools
When you publish a new version, existing users stay on their pinned version until they explicitly update or opt into auto-updates.

Skill Metadata Reference

FieldRequiredDescription
nameUnique skill identifier (kebab-case)
versionSemantic version
descriptionOne-line description
categoryTaxonomy category
tagsNoSearch tags
platformsNoCompatible AI platforms
tools_requiredNoTools the skill needs (e.g., web_search)
min_contextNoMinimum context window in tokens
Submit a pull request to the skills repository with your SKILL.md. Skills that get featured in the registry are selected based on:
  • Clear, specific instructions
  • Real-world utility
  • Good test coverage
  • Execution report volume (after initial publish)