agent-skills decisions: why the code looks like this