# Skill Creator

Create, update, or package agent skills.

- Repository: https://github.com/HKUDS/nanobot (49730 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add HKUDS/nanobot --skill skill-creator -g -a claude-code -y`
Codex: `npx skills add HKUDS/nanobot --skill skill-creator -g -a codex -y`
Cursor: `npx skills add HKUDS/nanobot --skill skill-creator -g -a cursor -y`
Gemini CLI: `npx skills add HKUDS/nanobot --skill skill-creator -g -a gemini-cli -y`

## Description

Create, update, or package agent skills.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Skill Creator

This skill provides guidance for creating effective skills.

## About Skills

Skills are modular, self-contained packages that extend the agent's capabilities by providing
specialized knowledge, workflows, and tools. Think of them as "onboarding guides" for specific
domains or tasks, they transform the agent from a general-purpose agent into a specialized agent
equipped with procedural knowledge that no model can fully possess.

### What Skills Provide

1. Specialized workflows - Multi-step procedures for specific domains
2. Tool integrations - Instructions for working with specific file formats or APIs
3. Domain expertise - Company-specific knowledge, schemas, business logic
4. Bundled resources - Scripts, references, and assets for complex and repetitive tasks

## Core Principles

### Concise is Key

The context window is a public good. Skills share the context window with everything else the agent needs: system prompt, conversation history, other Skills' metadata, and the actual user request.

**Default assumption: the agent is already very smart.** Only add context the agent doesn't already have. Challenge each piece of information: "Does the agent really need this explanation?" and "Does this paragraph justify its token cost?"

Prefer concise examples over verbose explanations.

### Set Appropriate Degrees of Freedom

Match the level of specificity to the task's fragility and variability:

**High freedom (text-based instructions)**: Use when multiple approaches are valid, decisions depend on context, or heuristics guide the approach.

**Medium freedom (pseudocode or scripts with parameters)**: Use when a preferred pattern exists, some variation is acceptable, or configuration affects behavior.

**Low freedom (specific scripts, few parameters)**: Use when operations are fragile and error-prone, consistency is critical, or a specific sequence must be followed.

The rest: https://github.com/HKUDS/nanobot/blob/HEAD/nanobot/skills/skill-creator/SKILL.md
