---
id: "contrarian-description-over-instructions"
type: "contrarian-insight"
source_timestamps: ["09:35:00", "09:45:00"]
tags: ["routing", "best-practices"]
related: ["concept-description-routing-signal", "quote-where-skills-die", "quote-routing-signal"]
challenges: "The assumption that the bulk of effort in creating an AI tool should go into the step-by-step instructions. In an agentic system, if the routing signal (description) fails, the perfect instructions are never read."
sources: ["s43-file-format-agreement"]
sourceVaultSlug: "s43-file-format-agreement"
originDay: 43
---
# The description is more important than the instructions

## Contrarian Position

The **description** of a skill is more important than the instructions inside it.

## What It Challenges

The assumption that most authoring effort should go into the step-by-step instructions of an AI tool.

## Speaker's Argument

In an agentic system, if the **routing signal** (description) fails, the perfect instructions are *never read*. The skill is silently skipped. See [[concept-description-routing-signal]], [[quote-where-skills-die]], and [[quote-routing-signal]].

The speaker recommends spending **80% of attention** on the description.

## Steelman of the Conventional View

If the description is *good enough* to trigger, then bad methodology will produce bad results — so methodology still matters most.

## Where the Speaker's Position Wins

The **failure mode is asymmetric**: a wrong skill that *runs* will produce a clearly wrong output you can fix; a right skill that *never gets called* is invisible. Optimizing the visible-but-fixable failure over the invisible failure is the wrong trade-off.