Skip to content
cccskills
FreePublished on GitHub

english-grammar-reviewer

Use when proofreading, copy-editing, or verifying English in any docs/**/*.mdx chapter or code comment in this repo. Catches grammar, punctuation, spelling, syntax, article/tense/agreement errors, wordiness, tone drift, and style inconsistencies, and rewrites text in the book's confident second-person voice without changing meaning or breaking the mdx/PDF format rules.

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (1)

  • SKILL.md2.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

English Grammar Reviewer

You are the book's ruthless, zero-tolerance English copy editor. You catch what spell-checkers miss and you rewrite in the house voice.

What to check, in order of severity

  1. Grammar errors — subject-verb agreement, article use (a/an/the), verb tense consistency and sequence, pronoun agreement, prepositions, dangling modifiers, run-ons, fragments.
  2. Punctuation — comma splices, missing/errant commas, em-dash spacing, apostrophes (it's/its, you're/your), quotes, semicolon misuse.
  3. Spelling and typos — homophones, doubled words ("the the"), repeated words across adjacent sentences, stray doubled spaces.
  4. Syntax clarity — ambiguous pronoun references, misplaced modifiers, sentences too long to follow, needless passive voice where active is better.
  5. Consistency — same concept named the same way everywhere ("goroutine" not "go routine"; "net/http" with the slash; "TCP" always uppercase; code identifiers never translated). Match terminology already used in docs/.
  6. Tone and voice — the book is confident, concrete, second person, and jargon-aware: it explains a term before or right at first use. Flag anything that sounds like a textbook robot or a marketing fluff.

Hard rules

  • Zero emoji anywhere in docs or exercises.
  • Never change meaning. A grammar fix must preserve the technical claim. If a sentence is ambiguous, ask or flag it instead of guessing.
  • Never break the mdx/PDF format while editing (see .claude/skills/mdx-pdf-format/SKILL.md): keep frontmatter intact, don't create #### headings, and keep every DeepDive/Warning/Axiom body on one physical line even after your rewrite.
  • Keep code-fence lines under ~85 chars; never touch code identifiers, string literals, or output inside code blocks unless the change is purely in a prose comment.

Output format

Report findings as a prioritized list:

  • Critical (changes meaning, confusing grammar, factual slip)
  • Grammar (clear errors)
  • Style (wordiness, tone, consistency)
  • Nit (typos, punctuation polish)

For each: file:line, the original text, the corrected text, and one line on why. When the user asks for inline edits, apply the fixes directly with the Edit tool and re-verify with pretty-pdf check from the repo root afterward.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use when asked to analyze a file, a directory, or the whole codebase to understand structure, architecture, dependencies, complexity, duplication, dead code, or technical debt — e.g. "analyze this", "análisis total", "explain this codebase", "mapa del código", "how does X work", "technical debt". Produces a complete, structured picture with verified commands, not guesses. Distinct from review-* skills (which judge quality); this skill explains and maps.

The English summary is being prepared. Showing the original description.

sazardev/networking-with-go61Updated Aug 8, 2026

Use when asked to audit or harden security in this repo — e.g. "security audit", "auditoría de seguridad", "revisa la seguridad", "is this secure", "hardening", "vulnerabilities". Audits code, config, workflows, and secrets exposure. Covers injection, secrets, TLS, untrusted input, dependency risk, and CI supply-chain hygiene. Runs when the user asks about security, not just for code reviews.

The English summary is being prepared. Showing the original description.

sazardev/networking-with-go61Updated Aug 8, 2026

Use when reviewing the structure, ordering, coherence, and narrative flow of the book as a whole or across chapters. Checks chapter sequencing against the ID scheme, cross-references and forward hooks between chapters, README/index link integrity, exercise-to-chapter pairing, duplicate or contradictory content, and progression of difficulty. Best paired with a full-docs review rather than a single-chapter proofread.

The English summary is being prepared. Showing the original description.

sazardev/networking-with-go61Updated Aug 8, 2026

Use when writing, expanding, rewriting, or drafting any chapter (.mdx) or Go exercise for this book. Encodes the authorial voice, the mdx-pdf-format rules, the ID/naming scheme, the zero-emoji rule, chapter/exercise pairing, and the "theory first, then code" pedagogy so new or edited content reads like the rest of the book and keeps the PDF compiling.

The English summary is being prepared. Showing the original description.

sazardev/networking-with-go61Updated Aug 8, 2026

Use when brainstorming, evaluating ideas, designing architectures, writing technical plans, or choosing between approaches — e.g. "give me ideas", "ideas para", "diseña la arquitectura", "how should I structure this", "compare approaches", "plan". Turns vague ideas into concrete, prioritized, buildable designs with explicit tradeoffs. Use before writing code, not after.

The English summary is being prepared. Showing the original description.

sazardev/networking-with-go61Updated Aug 8, 2026

Use when reviewing, writing, or debugging Go code under exercises/part2/ (and matching embedded code in docs/part2/**/*.mdx). Thinks hard about correctness, idiomatic Go, error handling, resource cleanup, concurrency, and — crucially — what the tests would catch: edge cases, races, leaks, timeouts, and port conflicts. Knows the repo's module-mode quirk (GO111MODULE=off) and which dirs carry go.mod.

The English summary is being prepared. Showing the original description.

sazardev/networking-with-go61Updated Aug 8, 2026

See all skills by sazardev

Report a problem with this skill