chore: add technical docs guidance to human-writing - #1645
Open
cmpadden wants to merge 1 commit into
Open
Conversation
5 tasks
Contributor
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
AndrewBarba
reviewed
Aug 4, 2026
cmpadden
force-pushed
the
add-writing-guidelines-skill
branch
from
August 4, 2026 22:07
fd8080a to
ea7b3af
Compare
cmpadden
force-pushed
the
add-writing-guidelines-skill
branch
from
August 4, 2026 22:18
ea7b3af to
8e9dfa5
Compare
cmpadden
force-pushed
the
add-writing-guidelines-skill
branch
from
August 4, 2026 22:19
8e9dfa5 to
e3b4a9e
Compare
cmpadden
force-pushed
the
add-writing-guidelines-skill
branch
from
August 4, 2026 22:22
e3b4a9e to
1f13a06
Compare
Signed-off-by: Colton Padden <colton.padden@vercel.com>
cmpadden
force-pushed
the
add-writing-guidelines-skill
branch
from
August 4, 2026 22:31
1f13a06 to
9c6a457
Compare
AndrewBarba
approved these changes
Aug 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Follow-up to #1644. Extend the existing
human-writingskill with guidance for eve's technical documentation.The landed skill's general editing, drafting, detection, voice-preservation, and AI-pattern guidance remains intact. This adds a technical documentation mode covering audience and page goals, neutral instructional voice, verified behavior, consistent terminology, page structure, links, placeholders, and TypeScript examples. The existing evaluation checklist gains focused checks for those rules.
The skill remains self-contained and continues to support its original non-documentation use cases. This is agent tooling only and does not change the published
evepackage, documentation, or runtime behavior.Validation
git diff --check origin/main...HEADTests and a changeset are not applicable to this Markdown-only agent-tooling change.
Checklist
CONTRIBUTING.mdevepackagegit commit --signoff)