Creating Custom Skills for Claude: Structure, Recording, and Best Practices

ArticleAnthropicTutorial

Anthropic details how to build, structure, and test custom skills for Claude. Skills augment the assistant with specialised domain knowledge or repeatable workflows, created either manually via a skill.md file or generated from screen recordings on macOS.

Key points

  1. Availability: Accessible on Free, Pro, Max, Team, and Enterprise plans with code execution enabled, as well as in beta for Claude Code and API users.
  2. macOS screen recording: Pro, Max, and Team users can capture workflows up to 10 minutes in Cowork for Mac, which Claude analyses to propose or update a skill.
  3. Structure: Each skill requires at least a skill.md file with YAML frontmatter containing name (max 64 characters) and description (max 200 characters) for progressive disclosure.
  4. Scripts and resources: Skills can include supplemental documentation and executable code (such as Python or JavaScript/Node.js) with dependencies.
  5. Open specification: The architecture aligns with the open standard at agentskills.io to ensure interoperability across platforms.

Why it matters

Custom skills allow organisations to codify repeated tasks and operational guidelines without bloating conversational context. Because Claude uses the metadata to decide when invocation is needed, complex multi-file skills load only when relevant.

Analysis

Anthropic's documentation marks a shift towards standardised, modular agent capabilities. The demonstration recording feature in Cowork for Mac lowers the barrier for non-programmers, turning desktop actions and narration into reproducible instructions. At the same time, the inclusion of executable scripts highlights security implications, requiring users to avoid hardcoded secrets and adhere to MCP-based service connections.

Found in

Summary generated by AI (Gemini 3.8 Flash, 27 September 2026). It may contain errors – the original source is authoritative.

Similar in content, found by the AI search.

  • Article:Anthropic

    Extending Claude Code with Skills: Architecture and Best Practices

    Anthropic details the skills system for Claude Code. Developers can encapsulate recurring procedures and workflows inside SKILL.md files built on the open Agent Skills standard, supporting dynamic context injection and subagent delegation.

    AI & LLMs· Tool

  • Repository:anthropics/skills

    Anthropic Skills: Reference Repository and Specification for Claude Agent Skills

    Anthropic provides a public repository containing example skills, templates, and specifications for Claude's Agent Skills standard. Skills package instructions, scripts, and resources inside folders with a central SKILL.md file to enable repeatable workflows ranging from document generation to technical testing.

    174.3kstarsPython

    AI & LLMs· Resource

  • Article:Barry Zhang, Keith Lazuka, Mahesh Murag

    Anthropic Introduces Agent Skills: Modular File-Based Capabilities for AI Agents

    Anthropic has introduced Agent Skills, an open specification allowing agents like Claude to dynamically load procedural knowledge and executable scripts from structured folders. The approach uses progressive disclosure to keep system prompts lean while providing access to deep domain expertise.

    AI & LLMs· Announcement

  • Video

    Video:CURT

    Anthropic's Ten Updated Rules for Building Claude Skills

    Jay (RoboNuggets / CURT) breaks down ten new best-practice rules from Anthropic's updated guide for building Claude skills with modern models such as Claude 5.5, highlighting modular context structure, token efficiency, and deterministic guardrails.

    AI & LLMs· Tutorial

  • Video

    Video:Hyperautomation Labs

    How Anthropic Employees Use Claude Skills and How to Build Them

    Anthropic employees use standardized Claude Skills rather than ad-hoc prompting for recurring internal workflows. The video examines examples from Anthropic's finance and legal teams, explains the progressive disclosure loading mechanism, and details how to build a skill in Claude Code or claude.ai.

    AI & LLMs· Tutorial

Let's talk about your project

Locations

  • Mattersburg
    Johann Nepomuk Bergerstraße 7/2/14
    7210 Mattersburg, Austria
  • Vienna
    Ungargasse 64-66/3/404
    1030 Wien, Austria

Parts of this content were created with the assistance of AI.