#Publishing Skills

Share your AI agent capabilities with the community by publishing skills to Agent Skill Hub.

#What is a Skill?

A skill is a reusable capability that an AI agent can use, defined by:

• SKILL.md — Metadata and instructions
• Supporting files — Code, config, or documentation (optional)

#SKILL.md Format

The SKILL.md file is the core of your skill. It uses YAML frontmatter for metadata and Markdown for documentation.

#Example SKILL.md

---
name: Data Analysis
slug: data-analysis
description: Analyze CSV and JSON data with statistical summaries
author: your-username
version: 1.2.0
categories:
  - data
  - analysis
tags:
  - csv
  - json
  - statistics
---

# Data Analysis

This skill enables your agent to perform statistical analysis on structured data files.

## Capabilities

- Parse CSV and JSON files
- Calculate statistical summaries (mean, median, mode, std dev)
- Generate data visualizations
- Export results to multiple formats

## Usage

When working with data files, the agent will:

1. Load the data file
2. Detect the schema and data types
3. Perform requested analysis
4. Present findings with visualizations

## Configuration

No additional configuration required.

## Examples

### Analyze a CSV file

"Analyze this sales_data.csv and show me monthly trends"

### Statistical summary

"Give me summary statistics for the age column in users.json"

#Frontmatter Fields

#Slug Naming

• Use lowercase letters, numbers, and hyphens
• Keep it descriptive but concise
• Must be unique within your namespace
• Examples: api-client, data-analysis, slack-integration

#Repository Structure

#Single Skill Repository

my-skill/
├── SKILL.md          # Required: Skill definition
├── README.md         # Optional: Additional docs
└── src/
    └── helper.js     # Optional: Supporting code

#Multi-Skill Repository

my-skills/
├── skill-one/
│   └── SKILL.md
├── skill-two/
│   └── SKILL.md
├── skill-three/
│   └── SKILL.md
└── README.md

#Publishing Methods

#Method 1: GitHub Import (Recommended)

1. Push to GitHub

   git push origin main

2. Import via Web Platform

   • Log in to agentskillhub.dev
   • Go to Import page
   • Enter your repository URL
   • Select skills to import
   • Publish

3. Update Skills

   • Push new commits to GitHub
   • Re-import to update the platform

#Method 2: API Upload (Coming Soon)

Direct API upload will be available for CI/CD integration.

#Versioning

Use Semantic Versioning:

• MAJOR — Breaking changes
• MINOR — New features, backward compatible
• PATCH — Bug fixes, backward compatible

#Version Updates

When you re-import a skill with a new version:

• Old versions remain available
• New installs get the latest version
• Existing installs can update via skhub sync

#Best Practices

#1. Clear Descriptions

Write a clear, concise description. Users scan these quickly.

# Good
description: Generate SQL queries from natural language with schema awareness

# Bad
description: SQL tool

#2. Good Documentation

Include in your SKILL.md:

• What the skill does
• How to use it
• Configuration options
• Example prompts

#3. Categorize Properly

Choose relevant categories and tags for discoverability:

categories:
  - devops
  - monitoring
tags:
  - docker
  - kubernetes
  - logs

#4. Test Before Publishing

Verify your skill works as expected:

1. Install locally: skhub add ./local-path
2. Test with your agent
3. Fix any issues
4. Publish

#5. Keep Files Small

• SKILL.md should be under 100KB
• Supporting files should be necessary
• Large assets should be linked, not embedded

#Skill Categories

Common categories include:

• api — API clients and integrations
• data — Data processing and analysis
• devops — DevOps and infrastructure
• communication — Messaging, email, notifications
• automation — Workflow automation
• security — Security tools and scanners
• testing — Testing utilities
• documentation — Documentation generators

#Creating a Skillset

Group related skills into a skillset:

1. Log in to the web platform
2. Navigate to your account
3. Click "New Skillset"
4. Add skills from your published skills
5. Publish to make it public

Skillsets are useful for:

• Team onboarding kits
• Domain-specific collections
• Tutorial bundles
• Workflow templates

#Troubleshooting

#Import Fails

• Verify SKILL.md has all required frontmatter
• Check that YAML syntax is valid
• Ensure slug is unique

#Skill Not Appearing

• Check that the repository is public
• Verify the SKILL.md file is in the root or subdirectory
• Wait a moment for indexing (usually instant)

#Version Conflicts

• Ensure version is incremented for updates
• Use semantic versioning consistently
• Check for typos in version strings

#Next Steps

• CLI Reference — Learn how users install your skills
• API Reference — Programmatic access to skills
• Visit agentskillhub.dev to start publishing