Revert the docs re-sync — quoting SKILL.md text and narrating the cha…
Revert the docs re-sync — quoting SKILL.md text and narrating the change was bad documentation The two FAQ edits quoted the literal new SKILL.md instruction text and described "now X, replacing Y, intended to fix Z" — implementation-change narration, exactly what .agents/writing-docs.md's "explain the why, not the process" / "never reproduces the SKILL.md steps" rules argue against. It also duplicates content that lives in SKILL.md, which is precisely what caused the stale quote this PR already had to fix once. That story belongs in the changeset/CHANGELOG, not the docs page. Reverted both files to their pre-PR state; the changeset stays as the record of what changed and why. Co-Authored-By: Claude <noreply@anthropic.com>
What happened
The commit on August 15, 2026, reverted edits to the SKILL.md file and related documentation that had inaccurately quoted the instruction text and provided excessive implementation detail instead of focusing on the rationale behind changes.
Why it matters
By reverting to clearer documentation practices, this change supports better understanding among developers working with SKILL.md and maintains instruction integrity without unnecessary duplication. It emphasizes the importance of concise and relevant documentation in development workflows.