Agent skills: preserve flexibility while supplying context

PostHog shares practical guidance for writing skills that help agents without locking them into a brittle workflow. The core idea is to load context progressively, define the goal and constraints, then let the agent choose steps that fit the repository and runtime environment.

The article also addresses maintenance: separate durable structure from fast-changing details, point to a single source of truth, and regenerate skills instead of patching them indefinitely. Skills carry context and upkeep costs, so they make most sense for recurring tasks where agents lack essential context or perform poorly by default.