# I Stopped Installing Claude Skills. Here's What I Do Instead.

## Executive summary

The video provides an advanced deep dive into AI agent skills (used by models like ChatGPT, Claude, and Codex), arguing that these 'superpowers' are often misunderstood. Skills are not traditional apps; they are sets of instructions that must be designed to be both readable by humans for auditing and highly functional for the AI agent during runtime. The speaker emphasizes moving beyond simply collecting skills and instead focusing on structured development, conflict resolution across multiple skills, and utilizing specialized tools like a 'Skill Builder' to ensure reliable, production-grade performance.

## Key takeaways

- Skills are not applications (apps): A skill is simply a set of instructions for the AI agent. Unlike apps, skills do not load their full functionality upfront; only the name and description are loaded initially. The full instruction set is only invoked when the task matches the description, making loading order critical.
- The Core Reframing: Dual Audience Design: Skills must be written for two audiences simultaneously: the AI agent (for utility) and the human developer (for readability and auditing). If humans cannot read them, developers cannot understand what is being given to the AI.
- Auditing and Conflict Resolution: As agents accumulate many skills (e.g., 25+), conflicts can dull the results because the AI averages out competing instructions. Advanced builders must audit their setup to resolve these performance degradations.
- The Role of Structured Development: To ensure reliability, developers should use tools (like the 'Skill Builder') that enforce best practices for skill files, ensuring clarity in the front matter and structure while maintaining human readability.

## Technical details

- Skill Definition: A skill is defined as a set of instructions used by an AI agent (e.g., ChatGPT, Claude) to complete a specific job or task.
- Skill Invocation Mechanics: When calling a skill, the model first loads only the name and description; the full set of instructions is only invoked when the agent determines the task matches the description.
- Skill File Structure: A skill is fundamentally a directory containing files like `skill.markdown`, which holds detailed operating instructions and examples.
- Advanced Skill Management: The speaker introduces an 'advanced builder skill' designed to audit existing setups, identify conflicts across multiple skills, and help resolve performance degradation caused by additive complexity.

## Practical implications

- When building or integrating AI capabilities, treat skills as structured code modules rather than simple add-ons.
- Always audit the context window usage and skill descriptions to prevent vague instructions from overloading the model's attention.
- Prioritize developing a standardized process for documenting skill lineage and conflict resolution before scaling up the number of integrated tools.
- Focus on making skills transparently readable by humans (for auditing) while ensuring they meet agentic best practices.

## Topics

AI Agents, Skill Development, Prompt Engineering, System Architecture, Context Management, Nate's Newsletter, Matt Pocock's Five Claude Skills

Source: https://www.youtube.com/watch?v=up0Bsf3f0Xc