The Commonplace
Home Papers Evidence Explore Trends Syntheses Digests References Docs 🎲 Workforce Futures
← Papers
Direction, evidence grade, and study type are AI-generated labels (gpt-5-mini), not human-verified. Syntheses are LLM-written. "Tensions" are machine-detected candidates, not confirmed contradictions. A research-acceleration tool, not peer review. How this is built →

Distilling prior runs into reusable 'skills' stabilises LLM agent execution—reducing setup, format and verification errors—because skills act as procedural anchors rather than mere fact injections; however, as skill libraries grow or contexts change, retrieval failures and contextual mismatch remain the main bottlenecks.

Demystifying Agent Skills: Why They Work-Until They Don't
Zhiyuan Jiang, Fangrui Huang, Hanwen Xing, Xander Wu, Yipeng Gao, Rui Cao, Mengdi Wang, Shilong Liu, Yijiang Li · August 14, 2026
arxiv descriptive medium evidence 7/10 relevance Full text usable extracted full text Source PDF

Structured author observations

Linked only from stored provider relations; the raw author line above is never matched by name.

Arxiv

Latest observation:

  1. Zhiyuan Jiang unresolved corpus identity
  2. Fangrui Huang unresolved corpus identity
  3. Hanwen Xing unresolved corpus identity
  4. Xander Wu unresolved corpus identity
  5. Yipeng Gao unresolved corpus identity
  6. Rui Cao unresolved corpus identity
  7. Mengdi Wang unresolved corpus identity
  8. Shilong Liu unresolved corpus identity
  9. Yijiang Li unresolved corpus identity

Semantic Scholar

Latest observation:

  1. Zhiyuan Jiang provider ID
  2. Fan Huang provider ID
  3. Hanwen Xing provider ID
  4. Xander Wu provider ID
  5. Yipeng Gao provider ID
  6. Rui Cao provider ID
  7. Mengdi Wang provider ID
  8. Shilong Liu provider ID
  9. Yijiang Li provider ID
Distilled skills improve LLM agent performance mainly by providing procedural anchors that stabilize noisy execution traces, but retrieval quality and contextual compatibility (not just finding the exact ground-truth skill) determine downstream success and create key failure modes.

Citation observations

Cumulative provider counts captured on specific dates; providers are never combined.

Skills have emerged as a practical and effective approach for enhancing LLM agents at inference time through structured packages of knowledge. However, existing evaluations largely measure whether skills improve aggregated task success, leaving a more fundamental question underexplored: \emph{\textbf{When do skills help, why do they work, and where do they fail?}} Through controlled experiments across various benchmarks, agent harnesses and LLMs, we isolate the effects of representation, outcome annotation, retrieval difficulty, and cross-framework robustness of skills. To further answer this question, we design a contrastive study that combines controlled quantitative experiments with paired trajectory analysis. We normalize 8,135 trial records from controlled experiments and retain 238 valid unique labels from 240 open-coded records. We consolidate these observations into a taxonomy of three high-level categories and twelve skill-use modes: skills work when noisy trajectories become procedural anchors that stabilize execution. Skills improve over Workflow Memory by 6.06 points in matched comparisons. Procedural anchoring accounts for 65.7\% of skill cases, versus 4.5\% for explicit knowledge injection, showing that skills stabilize action rather than inject missing facts. Retrieval is a separate bottleneck: as pools grow from 5 to 100, actual-use precision falls from 29.6\% to 3.3\%. Confusable distractors impair offline identification, yet downstream success remains stable; exact ground-truth invocation is neither sufficient nor necessary. Skills fail under brittle assumptions, incompatible contexts, or insufficient adaptation. These findings move evaluation beyond aggregate success rates and guide reliable self-evolving agents.

Summary

Main Finding

Skills help agents primarily by acting as procedural anchors that stabilize noisy multi-step execution (not by injecting missing factual knowledge). Distilled SKILL artifacts outperform raw workflow memory in matched settings (≈ +6.06 percentage points) because they compress and standardize procedures. However, skills are not universally reliable: retrieval difficulty, confusable distractors, context mismatch, and brittle assumptions create separate failure modes. Exact retrieval of the ground-truth skill is neither necessary nor sufficient for success.

Key Points

  • Dominant mechanism: procedural anchoring (65.7% of skill-use cases in the authors’ taxonomy). Skills supply usable ordering, checklists, tool sequences and verification plans that reduce execution-layer failures.
  • Knowledge injection is rare: only ~4.5% of cases are explained by skills supplying facts the agent lacked.
  • Skills vs Workflow Memory: skills improve task success over workflow memory by ~6.06 percentage points in matched experiments; workflow memory tends to preserve noisy exploration, failed branches and verbose traces that can increase timeouts and drift.
  • Retrieval is a critical bottleneck:
    • As candidate-pool size grows from 5 to 100, actual-use precision drops from 29.6% to 3.3%.
    • Hard-negative/confusable distractors substantially reduce offline identification accuracy (embedding ranking and explicit selection), but downstream execution success does not fall in direct proportion: related non-ground-truth skills can still be useful.
    • Selecting the “correct” skill does not guarantee success; invocation compatibility, adaptation, and runtime constraints matter.
  • Failure modes: brittle assumptions embedded in skills, applied in incompatible contexts, weak/no adaptation when invoked, resource/timeouts, capability/safety limits, and verification/infrastructure errors.
  • Taxonomy: the authors consolidate observations into 3 high-level categories and 12 skill-use modes (examples: guided success, execution & verification failures, invocation & budget problems).

Data & Methods

  • Datasets & benchmarks:
    • Controlled experiments on Terminal-Bench (realistic command-line tasks with isolated environments and test-based verification) and SkillsBench.
    • Collected balanced pools of successful and failed trajectories per task; constructed fixed-budget composition grids (mixtures labeled 5s0f → 0s5f).
  • Trials and coding:
    • Normalized 8,135 trial records from controlled experiments.
    • Sampled 240 trajectories for open coding; 238 valid unique labels consolidated into the final taxonomy.
  • Models and agent pairings:
    • Primary experiments: Codex + GPT-5.3-Codex and Gemini CLI + Gemini-3.1-Pro-Preview.
    • Retrieval diagnostics used Qwen3-Embedding-0.6B; one retrieval set used GPT-5.4 for Codex pairing (availability caveat).
  • Experimental conditions:
    • Representation comparison: Raw (no prior experience), Workflow Memory (cleaned traces), Skill (distilled SKILL.md from same traces).
    • No-hint setting: same trajectories but remove explicit success/failure annotations to separate outcome-signal effects.
    • Cross-framework transfer: artifacts built in one agent framework (Codex) tested in another (Gemini CLI).
    • Retrieval experiments (three arms):
      • Arm 1: embedding-based ranking without execution.
      • Arm 2: explicit agent selection (no execution).
      • Arm 3: full-pool real execution (skill selection and invocation during task runs).
    • Pools: each task paired with a candidate pool containing the ground-truth skill plus k−1 real distractors (random / similar / dissimilar).
  • Evaluation protocol:
    • Tasks executed in fixed Docker environments; verifier tests used to measure success.
    • Typical downstream execution: n = 5 unique trials per task, parallelism 20.
    • Outcomes logged and trajectories analyzed to attribute mechanism labels.
  • Key quantitative metrics reported:
    • Skill advantage over Workflow Memory: +6.06 points (matched comparisons).
    • Procedural anchoring share: 65.7%; Knowledge injection: 4.5%.
    • Retrieval precision fall: 29.6% → 3.3% when pool size increases 5 → 100.

Implications for AI Economics

  • Value creation and ROI
    • Distillation investment: producing compact, standardized skills yields outsized operational gains relative to storing raw traces. Firms should prioritize tooling and processes that distill frequent successful procedures into reusable skills.
    • Marginal returns diminish with library size unless retrieval quality scales: adding more skill artifacts without improving retrieval or curation can sharply reduce usable precision and raise search costs.
  • Product and market design
    • Skill marketplaces and services should price/position offerings by retrieval cost and confusability: highly specific, high-utility procedural skills are more valuable but require better indexing and disambiguation.
    • Portability and standards matter: skills that are framework-agnostic or follow common interfaces have higher cross-product value; standardizing SKILL.md-like formats increases the transferable economic value of procedural assets.
  • Organizational learning and labor
    • Automation of repetitive procedural tasks benefits most from skills that stabilize execution; this lowers repeated rediscovery costs and reduces variance in outcomes, improving predictability for downstream business processes.
    • However, brittle skills can create systemic risk—poorly adapted skills can propagate failures. Organizations need governance (testing, validation, monitoring) and incentives for continuous adaptation and curation.
  • Infrastructure and operational costs
    • Retrieval infrastructure (embeddings, hard-negative handling, ranking) becomes a central economic lever. Investment in retrieval quality and candidate-pruning is often more valuable than simply expanding storage.
    • Verification and runtime debugging tooling mitigate the non-sufficiency of correct skill retrieval; investments here reduce downstream execution failure costs.
  • Policy and safety
    • Because skills are procedural and can embed brittle assumptions, regulation and auditing standards for automated procedural assets (especially in safety-critical domains) may be warranted.
    • Economic incentives should favor robust, adaptable skill design and explicit provenance (origin, confidence, applicability bounds).
  • Practical recommendations (economic priorities)
    • Prioritize distillation pipelines that produce concise procedural anchors rather than raw trace dumps.
    • Invest in retrieval systems that handle confusable distractors (hard-negative training, metadata, context-sensitive ranking).
    • Maintain hybrid stores: keep both distilled skills and some richer workflow traces for debugging and adaptation—use skills for execution, traces for revision.
    • Monitor library growth costs and employ curation/pruning to preserve high precision.
    • Standardize skill representation for transferability across agent frameworks to increase reusability and market scope.

Limitations to consider when applying these results - Experimental scope used specific benchmarks (Terminal-Bench, SkillsBench) and particular agent–model pairings; numeric magnitudes may differ in other domains (e.g., open web, robotics). - Some RQ4 experiments used a different model pairing due to availability (GPT-5.4 vs GPT-5.3), so cross-RQ numeric comparisons should be interpreted cautiously. - The study focuses on short-horizon verification via test-based evaluation; long-run adaptation and continuous learning dynamics may reveal additional economic trade-offs.

Summary takeaway: In economic terms, invest in producing and curating distilled procedural skills and in the retrieval/verification infrastructure that makes them actionable—this yields predictable, reusable value—but avoid assuming that increasing the count of stored artifacts alone will scale benefit.

Assessment

Paper Typedescriptive Evidence Strengthmedium — The paper reports extensive, controlled experiments (8,135 normalized trials, multi-model evaluations, a 240-trajectory open-coding study reduced to 238 labels) and compares matched conditions to isolate mechanisms, which supports credible within-domain claims. However, evidence is limited to specific agent frameworks, benchmarks (Terminal-Bench, SkillsBench, Terminal-Bench-Pro), and high-end proprietary LLMs with some model-version differences across experiments, reducing external validity and causal generalization beyond the evaluated settings. Methods Rigorhigh — Design uses careful within-task controls (same trajectories used to create both workflow memory and skill artifacts), systematic composition grids to vary provenance of evidence, cross-framework transfer checks, and complementary quantitative plus qualitative (open coding) analyses; retrieval is tested both offline and in full execution. Main methodological weaknesses are reliance on specific agent implementations and some model-version inconsistencies (e.g., GPT-5.3 vs GPT-5.4 across study arms) and the usual challenges of coding subjectivity and environment scope. SampleControlled experiments over Terminal-Bench, SkillsBench and Terminal-Bench-Pro tasks; evaluated with two primary agent–model pairings (Codex + GPT-5.3-Codex and Gemini CLI + Gemini-3.1-Pro-Preview), with RQ4 using GPT-5.4 for the Codex pairing; retrieval embedding uses Qwen3-Embedding-0.6B. Dataset includes 8,135 normalized trial records; 240 sampled trajectories underwent open coding (238 valid unique labels). Typical downstream execution used n=5 trials per task with parallelism 20; retrieval pools varied in size (e.g., 5 to 100 skills) with different distractor types. Themesproductivity human_ai_collab IdentificationWithin-task matched comparisons that hold underlying trajectories fixed while varying representation (Raw, Workflow Memory, Skill), use of fixed-budget composition grids (5s0f to 0s5f) and paired trajectory analysis; no-hint vs standard variants to isolate outcome-annotation effects; cross-framework transfer experiments (same artifacts evaluated in different agent frameworks); controlled candidate-pool manipulations (varying pool size and distractor difficulty) with offline embedding and explicit-selection diagnostics alongside full execution. GeneralizabilityEvaluations confined to software/terminal-style benchmarks (Terminal-Bench, SkillsBench) and may not generalize to other domains (e.g., dialogic assistants, physical robots, enterprise workflows)., Benchmarks and artifacts (SKILL.md, Workflow Memory format) reflect specific representation choices; other skill formats might behave differently., Experiments use high-end proprietary LLMs and particular agent frameworks; performance and mechanisms may differ for smaller models or different execution loops., Some RQ4 analyses use a different model version (GPT-5.4 vs GPT-5.3) which complicates cross-experiment comparisons., Open-coding taxonomy is based on sampled trajectories and may reflect annotator biases; operational outcomes in the wild (human-in-the-loop, changing dependencies) could diverge.

Claims (10)

ClaimDirectionOutcomeConfidence & EvidenceDetails
Skills improve over Workflow Memory by 6.06 points in matched comparisons. Output Quality positive Task success performance relative to Workflow Memory
Reading fidelity high
Study strength high
6.06 points
0.3
Procedural anchoring is the dominant mechanism through which skills help, accounting for 65.7% of skill cases, whereas explicit knowledge injection accounts for 4.5%. Organizational Efficiency positive Mechanism of effective skill use
Reading fidelity high
Study strength medium
n=238
65.7% procedural anchoring versus 4.5% explicit knowledge injection
0.18
Skills primarily stabilize action and execution rather than supplying missing factual knowledge. Organizational Efficiency positive Reliability and stability of agent execution
Reading fidelity high
Study strength medium
n=238
0.18
As the skill pool grows from 5 to 100 candidates, actual-use precision falls from 29.6% to 3.3%. Other negative Precision of skills actually used during task execution
Reading fidelity high
Study strength high
decline from 29.6% to 3.3%
0.3
Confusable distractor skills substantially impair offline identification or explicit skill selection. Decision Quality negative Offline skill-identification and explicit selection accuracy
Reading fidelity high
Study strength medium
not reported
0.18
Offline retrieval or selection accuracy does not determine downstream task success in a one-to-one manner. Output Quality mixed Relationship between skill-retrieval accuracy and final task success
Reading fidelity high
Study strength medium
not reported
0.18
Exact ground-truth skill invocation is neither sufficient nor necessary for successful task execution. Output Quality mixed Final task success conditional on skill invocation
Reading fidelity high
Study strength medium
not reported
0.18
Skills reduce several execution-layer failures, including environment-setup errors, output-format mismatches, service-lifecycle failures, and shell-command corruption. Error Rate positive Frequency of execution and verification errors
Reading fidelity high
Study strength medium
n=8135
0.18
Workflow Memory can increase timeout and execution drift because it preserves irrelevant exploration, failed branches, and verbose process noise. Error Rate negative Timeout and execution-drift failures
Reading fidelity high
Study strength medium
n=8135
0.18
Skills fail when their guidance relies on brittle assumptions, is incompatible with the current context, or is insufficiently adapted to the task. Output Quality negative Successful application of retrieved procedural guidance
Reading fidelity high
Study strength medium
not reported
0.18

Notes