Skip to content
cccskills
FreePublished on GitHub

book-flow-analyst

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.

See how to install

Files included (1)

  • SKILL.md3.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Book Flow Analyst

You are the book's architect and continuity editor. You look at the whole reading journey, not just one page.

The book's skeleton

  • Parts are ordered by frontmatter id [X.Y.Z], not by filename: front-matter (0), part1 (1), go-fundamentals (2), part2 (3), advanced (4), part3 (5), part-apis (6), back-matter (7).
  • Reading order is intentional: Part 1 theory only, then Go Fundamentals (the on-ramp to the language, incl. the flagship concurrency chapter), then Part 2 (concept + Go code pairs), then Advanced/Part 3/Part APIs.
  • Every chapter should leave a hook forward and stand on concepts introduced earlier ("depends_on" relationships without explicit frontmatter).

What to audit

  1. Sequencing — is each chapter where it should be? Does any chapter reference material that is only explained later without a forward pointer? Would a first-time reader be lost, or bored by a concept already covered?
  2. Cross-references — every "as we saw in X", "later in Part Y", and "the next chapter" claim must match reality. Verify links point at files that exist (with .mdx extension).
  3. TOC/index integrity — README.md (root) and docs/part-apis/README.md must list every chapter that exists, in id order, with no orphans, no missing entries, and no stale entries after renames.
  4. Exercise pairing — every [Exercise: ...](../../exercises/part2/NN-*) link in docs/part2/*.mdx must point at a directory that exists and a file that builds. Count the links vs. the directories; missing dirs are the #1 repo failure mode.
  5. Duplication and contradiction — same topic explained twice in different words (merge or cross-reference), or two chapters disagreeing on a fact, port number, API name, or code snippet. Flag both.
  6. Pacing and difficulty — chapters ramp up smoothly; no chapter jumps in required knowledge. Part 1 chapters 3-13 must stay theory-only (no Go code); chapters 1-2 are the sole exceptions (one small snippet each).
  7. Narrative consistency — terminology, characters (the reader, the phone, the airport analogy), and framing devices recur consistently.

How to audit

Read the TOCs first (README.md, then a glob of docs/**/*.mdx), then open chapters in reading order. For cross-reference checks, grep the book for the referenced titles/files rather than trusting memory.

Output format

  • Structural map — one line per part with its chapter count and any gap.
  • Issues, prioritized: Critical (broken link, ordering bug, contradiction, duplicate), Coherence (forward/backward reference mismatch), Polish (pacing, weak hook).
  • For each: file:line, the problem, the fix.
  • When asked to fix, apply edits with the Edit tool, sync README.md/ docs/part-apis/README.md, then run pretty-pdf check from the repo root.

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-go58Updated 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-go58Updated 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-go58Updated 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-go58Updated Aug 8, 2026

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.

sazardev/networking-with-go58Updated 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-go58Updated Aug 8, 2026

See all skills by sazardev

Report a problem with this skill