Field guide / sub-domain

AI Agents: Skills & Distribution

29

sources in this field

Updated September 20, 2026

Current thesis

The shortest path to orientation.

This synthesis records claims and practices from the cited sources; reported outcomes and product capabilities have not been independently verified.

Skills distribution organizes markdown-based SKILL.md files (e.g., cold-email-copy) with self-improving loops: define criteria, run trials, score, rewrite, retest. Claude loads only relevant skills, keeping context small and preventing output drift. The AI PM OS centralizes 243 PM skills (v2.5, $499/year for up to 10 PMs), updated biweekly. Archify transforms codebases into typed JSON IR compiled into self-contained diagrams supporting five types with 8–12 core components; Architecture Delta mode compares snapshots for PR review. The 'show-me' skill instructs agents to pick the smallest visual format—pseudocode, call trees, component trees, file trees, Mermaid, or diffs—that clarifies key points. Diffs matched to topic shape typically outweigh full-block views unless content is mostly new. Matt Pocock notes this makes PR descriptions 'extremely easy to read.' Adoption mechanics now include: install the official Jev skill with npx skills add typesafe-ai/skills --skill typesafe-ai, then prompt your coding agent to analyze the project and identify where/how to apply it, offloading discovery work. Broader infrastructure remains constrained by model-guidance changes and lacks version control, ownership, searchability, and rigorous qualitative testing.

Evidence board

Claims worth carrying forward
01

Install the official Jev skill for existing projects with: `npx skills add typesafe-ai/skills --skill typesafe-ai`

02

Workflow for adopting a new tool/skill in an existing codebase: install the skill, then prompt your coding agent to analyze the project and identify where/how to apply it—offloading discovery work to the agent rather than manual audit.

03

Restructuring GTM around Claude Code as orchestrator (with tools like ColdIQ MCP as endpoints) cut a campaign build from two days of manual CSV-shuffling across four SaaS tools to one prompt and ~20 minutes of agent work.

04

Project structure convention: CLAUDE.md (auto-loaded, under 200 lines, standing rules) is kept separate from brain.md (ICP/personas/scoring, referenced explicitly via @brain.md) so GTM substance doesn't bloat context on unrelated runs.

05

brain.md should end with an explicit source-ranking block (e.g., closed-won CRM data > brain.md > last quarter's notes) so the model doesn't silently pick a winner when the ICP doc, intelligence store, and old notes contradict each other.

06

MCP setup gotchas: unquoted env vars in `claude mcp add` cause shell expansion that leaks the live API key into .mcp.json; always write explicit "type": "stdio" or a url-only remote entry silently fails; .mcp.json is read only at session start.

07

Never let Claude @-reference .env files—contents flow into the prompt, session transcript, and downstream outputs with no default block. Use a settings.json deny rule (Read(./.env) etc.) and hand the model a stripped .env.example instead.

08

Seven-step outbound loop: detect signal → score/tier (1-100 via scoring.md) → find contacts → enrich/validate (email then phone, phone ~10x cost of email) → generate tiered copy → route to sequencer → analyze results back into the intelligence store.

Adjacent fields

Key voices

Latest evidence

Recent additions

All synthesized insights →

Charlie Hills

Anthropic's Four Agent Loop Types: Turn, Goal, Time, Proactive

Anthropic's Claude Code team formally defines agentic 'loops' as cycles of work repeated until a stop condition is met, categorizing them into four types (turn-based, goal-based, time-based, proactive) by what gets handed off. Charlie Hills synthesizes the framework with practical commands (/goal, /loop, /schedule, skills) and a warning that every loop still needs an explicit stop condition or it burns tokens unattended.

Khe Hy

AI Skills Are Stuck in Single-Player Mode

Khe Hy argues that individually-created AI skills (5-20 per person on buyside teams) work well but lack infrastructure for sharing, versioning, ownership, and testing—creating organizational duplication and drift. A quoted proposal suggests Notion could become a collaborative skills library to solve this.