← All writing

4 posts

Agent experience

What an agent is allowed to do shapes everything else about the product.

Credentials, permissions, and the ways agents fail.

start here

Start at the top.

  1. 01
    the agent surface map: pick the cell before the prompt

    Chat-plus-approve works for a coding pair. It breaks a hosted operator and a custom actor. Pick the cell, then pick the credential model.

  2. 02
    the one line 95% of agent skills are missing

    An agent uses a skill's description to decide whether to load it. I scanned 200 public skills and found that 163 of 171 valid files weaken that signal.

  3. 03
    your 404 page has a blind spot

    An agent that follows a stale or hallucinated URL reaches a dead end. Agent 404 indexes live pages and returns ranked replacements.

  4. 04
    the MCP anti-pattern

    Converting an OpenAPI spec into tools gives an agent more endpoints to juggle. Start with the user's job and design the tool around that workflow.