Agent skill

Skill Development

by letta-ai in letta-ai/skills

Create and contribute skills to the communal knowledge base.

MITAuto-check passedKnowledge Management

Install Skill Development

skills CLI
$ npx skills add letta-ai/skills --skill skill-development -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install letta-ai/skills skill-development --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/letta-ai/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/meta/skill-development .claude/skills/skill-development && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skill-development
GitHub stars
147
Token cost
~941 tokens
SKILL.md length
345 words
Files
10 (incl. scripts, references)
Skills in repo
22
Repo updated
First seen
Licence
MIT

At a glance

Create and contribute skills to the communal knowledge base.

  • Works in 3 steps: Metadata (~100 words) - Always in context → SKILL.md body (<5k words) - When skill… → References (unlimited) - Loaded as…
  • Creating new skills
  • SKILL.md covers When to Use This Skill, Part 1: Creating Skills, Part 2: Contributing Skills and Scripts, plus 1 more section
  • Runs Python scripts from its folder

What it does

Skill Development is an agent skill from letta-ai/skills. Create and contribute skills to the communal knowledge base. Use when creating new skills, updating existing skills, or contributing learnings back to the repository.

Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts and reference files (for example `references/contribution-examples.md`, `references/pr-workflow.md` and `references/progressive-disclosure-research.md`).

It sits in Knowledge Management, covering Skill authoring and Knowledge bases. The repository describes itself as: A shared repository for skills. Intended to be used with Letta Code, Claude Code, Codex CLI, and other agents that support skills. The licence is MIT.

When your agent uses it

  • Creating new skills
  • Updating existing skills
  • Contributing learnings back to the repository

Example prompts

  • “/skill-development”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Metadata (~100 words) - Always in context
  2. SKILL.md body (<5k words) - When skill triggers
  3. References (unlimited) - Loaded as needed by agent

What it can do on your machine

Read from SKILL.md and the folder at commit 6785511. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Development loads about 941 tokens when it runs, and up to ~17k if it reads all its reference files. Until then it costs about 46 tokens; SKILL.md has 345 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~941
With references · SKILL.md plus every file in references/, read only if the agent opens them
~17k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from letta-ai/skills at commit 6785511, republished under its MIT licence (© letta-ai). 345 words, ~941 tokens.

Download SKILL.mdSave it as .claude/skills/skill-development/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
skill-development
description
Create and contribute skills to the communal knowledge base. Use when creating new skills, updating existing skills, or contributing learnings back to the repository.
license
MIT

Skill Development

Guide for creating effective skills and contributing them to the communal knowledge base.

When to Use This Skill

Creating skills:

  • Building a new skill for a specific domain or workflow
  • Updating an existing skill with improvements
  • Packaging skills for distribution

Contributing skills:

  • You discovered something that took significant time to figure out
  • Existing skill instructions were incomplete or led you astray
  • You repeatedly solve the same undocumented problem

Part 1: Creating Skills

Skill Structure
skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter (name, description)
│   └── Markdown instructions
└── Bundled Resources (optional)
    ├── scripts/      - Executable code
    ├── references/   - Documentation loaded as needed
    └── assets/       - Files used in output
SKILL.md Requirements
yaml
---
name: skill-name
description: What this skill does. Use when [triggers]. 
---

# Skill Name

[Instructions in imperative form...]

Metadata rules:

  • name: lowercase, hyphens, gerund form (e.g., creating-skills)
  • description: Lead with action verbs, end with "Use when [triggers]"
Writing Style

Write in imperative/infinitive form (verb-first), not second person:

  • ✅ "To accomplish X, do Y"
  • ❌ "You should do X"
Progressive Disclosure

Keep SKILL.md lean (<5k words). Move detailed content to references/:

  1. Metadata (~100 words) - Always in context
  2. SKILL.md body (<5k words) - When skill triggers
  3. References (unlimited) - Loaded as needed by agent
Scripts

Include scripts for tasks that:

  • Are repeatedly rewritten
  • Require deterministic reliability
  • Save significant tokens

Part 2: Contributing Skills

Core Philosophy

This repository is a living knowledge base. Skills must contain general-purpose knowledge that helps many agents - not project-specific configs or personal preferences.

What to Contribute
✅ Contribute❌ Don't Contribute
Patterns that appear 3+ timesOne-off solutions
General API/tool patternsProject-specific configs
Battle-tested workaroundsPersonal preferences
Gap in existing skillsAlready documented elsewhere
Validation Checklist

Before contributing, verify:

  • Is this generalizable beyond your specific context?
  • Have you seen this pattern multiple times?
  • Does this address a real gap vs. personal preference?
  • Would this help an agent on a completely different project?
Contribution Process
  1. Recognize - Notice patterns during work (time investment, repetition, corrections)
  2. Validate - Confirm pattern is general, not specific to your context
  3. Create branch - add/skill-name or fix/skill-name
  4. Submit PR - Clear description with rationale and evidence

See references/pr-workflow.md for detailed PR process.


Scripts

  • scripts/init_skill.py - Initialize skill directory structure
  • scripts/package_skill.py - Package skill for distribution
  • scripts/quick_validate.py - Validate SKILL.md format

References

  • references/recognizing-learnings.md - Patterns for spotting valuable learnings
  • references/validation-criteria.md - Detailed validation guidelines
  • references/pr-workflow.md - PR process and templates
  • references/contribution-examples.md - Real contribution examples
  • references/progressive-disclosure-research.md - Research on skill organization

© letta-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (scripts, references) in meta/skill-development of letta-ai/skills.

  • SKILL.md
  • LICENSE
  • references/contribution-examples.md
  • references/pr-workflow.md
  • references/progressive-disclosure-research.md
  • references/recognizing-learnings.md
  • references/validation-criteria.md
  • scripts/init_skill.py
  • scripts/package_skill.py
  • scripts/quick_validate.py

Open the folder on GitHubat commit 6785511

Compare with similar skills

Skill Development next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skill Development compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Development this skillletta-ai/skills147—~941Automated safety check: PassMIT
Book to Skill Convertervirgiliojr94/book-to-skill34k—~14kAutomated safety check: PassMIT
Open Knowledge Write Skillinkeep/open-knowledge4.4k—~3.7kAutomated safety check: PassGPL-3.0
Otodock PlatformOtoDock/oto-dock190—~2.3kAutomated safety check: PassCustom licence
Work Operating ModelNateBJones-Projects/OB14.7k—~2.2kAutomated safety check: PassCustom licence
Memory ImportPrismer-AI/PrismerCloud1.6k—~665Automated safety check: PassMIT

Similar skills

  • Book to Skill Converter

    virgiliojr94/book-to-skill

    Converts books and documents in PDF, EPUB, DOCX, HTML, Markdown, text, RTF or MOBI form into agent skills built from frameworks, principles, techniques and anti-patterns.

    34k GitHub stars~14k tokensUpdated 3 days ago
    Knowledge ManagementAuto-check passed
  • Open Knowledge Write Skill

    inkeep/open-knowledge

    A skill your agent uses when the user wants to create, author, write, or design a new Agent Skill (a SKILL.md) — for OpenKnowledge or for their editors — including requests like 'help me write a…

    4.4k GitHub stars~3.7k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Otodock Platform

    OtoDock/oto-dock

    How the OtoDock platform itself works and where every setting lives — installing and first-run setup, agents, AI engines, sessions, apps and sharing, checks, departments and delegation, shared…

    190 GitHub stars~2.3k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Work Operating Model

    NateBJones-Projects/OB1

    Conversation-first workflow for turning tacit work patterns into a structured operating model.

    4.7k GitHub stars~2.2k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Memory Import

    Prismer-AI/PrismerCloud

    Bulk-import an external knowledge base into Prismer memory via the three-layer import pipeline (07 §3.1).

    1.6k GitHub stars~665 tokensUpdated 8 days ago
    Knowledge ManagementAuto-check passed
  • Talk

    Abilityai/cornelius

    Conversational partner mode - delegates each exchange to the thinking-partner sub-agent, which embodies the knowledge base as its own memory and engages as an intellectual equal.

    109 GitHub stars~834 tokensUpdated 16 days ago
    Knowledge ManagementAuto-check passed

More from letta-ai/skills

All 22 skills in this repo
  • Visual Identity

    letta-ai/skills

    Build and maintain a persistent visual identity for your agent using Flux Kontext Pro.

    147 GitHub stars~2.6k tokensUpdated 7 days ago
    Auto-check passed
  • AI News

    letta-ai/skills

    Fetch and summarize recent AI news from curated RSS feeds (Hugging Face, VentureBeat, The Verge, OpenAI, Anthropic, DeepMind, etc.) and YouTube channels (Yannic Kilcher, Two Minute Papers, AI…

    147 GitHub stars~582 tokensUpdated 7 days ago
    Auto-check passed
  • Builds and debugs Letta Code channels, including first-party channel adapters and dynamic user channel plugins under ~/.letta/channels.

    147 GitHub stars~1.1k tokensUpdated 7 days ago
    Auto-check passed
  • Letta Configuration

    letta-ai/skills

    Configure LLM models and providers for Letta agents and servers.

    147 GitHub stars~1.3k tokensUpdated 7 days ago
    Auto-check: notes
  • Migrates deprecated Letta Filesystem folders/files to MemFS using markdown document corpora, chunking, local lexical search, and QMD semantic search via the memfs-search skill.

    147 GitHub stars~1.3k tokensUpdated 7 days ago
    Auto-check passed
  • Memfs Search

    letta-ai/skills

    Semantic search over agent memory files. An agent skill from letta-ai/skills.

    147 GitHub stars~901 tokensUpdated 7 days ago
    Auto-check passed

Questions about Skill Development

What does Skill Development do?

Create and contribute skills to the communal knowledge base. Skill Development is an agent skill from letta-ai/skills. Create and contribute skills to the communal knowledge base.

When should I use Skill Development?

Skill Development fits situations like: creating new skills; updating existing skills; contributing learnings back to the repository.

How do I install Skill Development in Claude Code?

Run `npx skills add letta-ai/skills --skill skill-development -a claude-code`. Or copy the skill folder (meta/skill-development in letta-ai/skills) into .claude/skills/skill-development in your project. Claude Code loads it when a task matches its description.

How do I install Skill Development in Codex?

Run `npx skills add letta-ai/skills --skill skill-development -a codex`. Or copy the skill folder (meta/skill-development in letta-ai/skills) into .agents/skills/skill-development in your project. Codex loads it when a task matches its description.

Can I use Skill Development in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add letta-ai/skills --skill skill-development -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-development, .gemini/skills/skill-development, .github/skills/skill-development and .opencode/skills/skill-development in your project.

What does Skill Development need to run?

Going by SKILL.md and its folder, Skill Development needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Skill Development access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Skill Development safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Skill Development use?

Skill Development is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Development use?

About 941 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 16k tokens, read only when the agent opens those files.

What are the alternatives to Skill Development?

Skills that share tags, products or a category with Skill Development: Book to Skill Converter (virgiliojr94/book-to-skill, 34k stars), Open Knowledge Write Skill (inkeep/open-knowledge, 4.4k stars), Otodock Platform (OtoDock/oto-dock, 190 stars) and Work Operating Model (NateBJones-Projects/OB1, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Development?

letta-ai (a GitHub organization) maintains it in letta-ai/skills, which has 147 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 1, 2026.

Source: letta-ai/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.