agent-friction-skill
A skill for AI agents to document agentic developer experience friction during a development flow.
This is a skill — a structured set of instructions — designed for AI coding agents. When an AI agent works on a development task with this skill active, it logs friction in real time: moments where it gets stuck, makes a mistake, needs better documentation, or wishes a tool worked differently. The result is a structured friction log that captures the agent's development experience as it happens.
The skill instructs the agent to record a chronological list of every tool call it makes, fold in any messages the user sends mid-task, and then produce a formatted log in markdown. The log contains a summary of the biggest pain points, a severity-coded chronological record of friction, and action items split into three categories — documentation gaps, framework issues, and open research questions. Items are coded by severity with color indicators.
The intended audience is developers and teams who want to systematically understand where AI agents struggle during coding workflows, so they can improve tooling, fix error messages, or update documentation. A finished log can be pasted into a web viewer (agent-friction-skill.vercel.app) that renders it in a collapsible, severity-coded layout; links are shareable via URL fragment, and nothing leaves the browser.