Skip to content
cccskills
FreePublished on GitHub

superior-docs

Create, reconstruct, synchronize, or automatically record durable repository documentation and curated implementation memory from current code, configuration, tests, accepted user intent, existing docs, and Git history. Use for project context, architecture, decisions, implementation change records, timelines, build and distribution guides, maintenance handoffs, or cross-session continuity. After verified material implementation work, record the outcome by default unless the user explicitly opts out. Do not use for incidental comments, raw prompt archiving, or non-material edits.

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

KodekaTeam/superior-skills23 stars(GitHub 23 + cccskills 0)

Run score Not tested

See how to install

Files included (6)

  • SKILL.md7.6 KB
  • references/automatic-change-recording.md12.1 KB
  • references/core-files.md2.4 KB
  • references/curated-implementation-memory.md5.1 KB
  • references/documentation-map.md3.7 KB
  • references/history-and-handoff.md2.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Superior Docs

Build documentation that lets a future maintainer recover the project's current shape, important decisions, and safe operating procedures without relying on chat history. Documentation is a maintained view of evidence, not a second source of invented truth.

Select the mode

  • Bootstrap: establish a useful docs/ system where none exists.
  • Record: capture a verified implementation, fix, refactor, configuration change, or feature outcome in the implementation timeline.
  • Memory: curate accepted intent, criteria, decisions, and maintenance knowledge into the existing timeline, implementation guide, or decisions ledger.
  • Synchronize: update affected documents after verified project changes.
  • Reconstruct: derive architectural evolution, releases, or maintenance history from repository evidence.
  • Handoff: capture the current implementation, boundaries, risks, and next work at the end of a substantial effort.

Do not ask the user to choose when the request already determines the mode.

Record implementation work by default

After verified material changes to code, configuration, schema, API behavior, security controls, build behavior, or user-visible functionality, create or update an implementation record unless the user explicitly asks not to create or update documentation.

Read references/automatic-change-recording.md whenever another implementation skill completes material work. It defines the default path, minimum bootstrap, entry schema, opt-out behavior, and exclusions.

Read references/curated-implementation-memory.md when user requirements, acceptance criteria, implementation decisions, or maintenance constraints should remain useful across sessions. Curate the accepted outcome and verified execution; never store raw prompts, chat transcripts, or hidden reasoning as project memory.

Do not wait for a separate documentation request and do not ask for routine permission. Treat an explicit opt-out such as “skip docs,” “do not document this,” or an equivalent project instruction as authoritative. An opt-out for one task is not a permanent preference unless the user says so.

Establish evidence

Inspect the relevant code paths, configuration, tests, scripts, deployment files, existing documentation, and repository instructions. Use Git history when historical sequence or releases are in scope.

Inspect repository status and the task's actual diff before attributing a change. In a dirty worktree, preserve unrelated user edits and do not describe pre-existing changes as outcomes of the current task.

Classify statements as:

  • Current fact: proven by the present repository or runtime evidence;
  • Accepted decision: recorded in an authoritative decision source or explicitly confirmed by the user;
  • Historical fact: supported by a commit, tag, release, migration, or dated artifact;
  • Planned work: explicitly proposed but not yet implemented;
  • Unknown: unresolved and stated as such.

Never turn a commit message, stale document, unused file, or plausible architecture into a current fact without corroboration.

Build the smallest useful documentation map

Read references/documentation-map.md when bootstrapping or reorganizing docs/. Always create an index and the three core documents when the user requests the full continuity system. Add specialized sections only when the repository has corresponding evidence and maintenance value.

Automatic change recording is a smaller bootstrap: when no documentation system exists, create only docs/README.md, docs/implementation-timeline/README.md, a stable feature-domain subfolder with its index, and the first verified change record. Do not fabricate the three core documents merely to satisfy the recording default.

Do not create empty directories, placeholder guides, or one file per imagined subsystem. A smaller linked set that stays accurate is better than an impressive tree nobody can trust.

Write for retrieval

  • Put one durable subject in each document and give it a stable path.
  • Start each document with purpose, scope, and last verified revision or date.
  • Link to authoritative code, configuration, commands, decisions, and related docs.
  • Record ownership and boundaries, not exhaustive file inventories that immediately go stale.
  • Use exact commands only after verifying them in repository sources or by safe execution.
  • Separate current state from history and future work.
  • Prefer concise tables for mappings, decisions, interfaces, or commands; use prose for rationale and constraints.
  • Name the authoritative source for volatile contracts and avoid manually duplicating generated schemas, command output, or configuration inventories.
  • Preserve ownership and update triggers: a document should make clear what event can make it stale and where a maintainer verifies it.

Read references/core-files.md when writing the documentation index, project context, architecture, or decisions ledger.

Reconstruct history carefully

Read references/history-and-handoff.md when using commits, releases, migrations, or earlier documentation to build timelines and handoffs.

Summarize change by outcome and architectural consequence. Do not dump every commit, treat commit order as causality, or claim a feature shipped because a branch once contained related code. Link facts to commits or tags when stable identifiers are available.

Synchronize without rewriting everything

After a change, update only documents whose claims became incomplete or false. Preserve useful history and append decisions when the repository follows an append-oriented record. Replace current-state descriptions when reality changed; do not retain both versions as if both remain active.

If documentation conflicts with working code or configuration:

  1. verify that the code path is active;
  2. check for an accepted pending migration or exception;
  3. update the stale document when authorized;
  4. report unresolved conflicts rather than choosing a preferred story.

Recording and synchronization are related but distinct. A material implementation receives a concise timeline record by default. Update current-state architecture, decisions, guides, or build documents only when their claims or procedures actually changed.

Verify

  • Re-open every changed document and follow its relative links.
  • Confirm commands, paths, names, versions, and ownership against current sources.
  • Check that the root index reaches every maintained document and does not point to placeholders.
  • Review the diff for secrets, credentials, private infrastructure details, personal data, or copied logs.
  • Confirm the document attributes only work supported by the current task's evidence and does not absorb unrelated dirty-worktree changes.
  • Report the evidence inspected, documents changed, historical limits, and unresolved unknowns.

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

Review or implement interface accessibility for semantics, keyboard operation, focus, contrast, status communication, zoom, and assistive technology. Use when accessibility is explicitly requested, required by the product contract, or a changed interaction creates substantial accessibility risk. Do not activate for every visual edit or use it as a generic design audit.

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

KodekaTeam/superior-skills23Updated Oct 29, 2026

Implement, harden, or review defensive security controls for REST APIs, including authentication and authorization boundaries, validation, rate limiting, abuse prevention, resource limits, SSRF defenses, safe errors, logging, and security tests. Use when API security, endpoint hardening, threat review, rate limiting, token handling, or sensitive business-flow protection is an explicit concern. Do not use for ordinary endpoint logic without meaningful security scope or for offensive exploitation.

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

KodekaTeam/superior-skills23Updated Oct 29, 2026

Design, implement, or assess project structure, module ownership, dependency boundaries, and safe file or folder organization. Use when project architecture, feature placement, separation of responsibilities, or architectural refactoring is a primary concern, including new framework projects. For a read-only assessment, do not modify files unless the user also requests changes; do not activate merely because ordinary feature work adds a file.

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

KodekaTeam/superior-skills23Updated Oct 29, 2026

Review a code change, diff, commit, branch, or pull request for actionable defects, regressions, security risks, compatibility breaks, and missing verification. Use when code review is the primary requested outcome. Keep the review read-only unless the user explicitly asks to implement fixes; do not use as a substitute for implementation or a specialized visual audit.

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

KodekaTeam/superior-skills23Updated Oct 29, 2026

Add, revise, or remove source-code comments while preserving executable behavior. Use for comment-only cleanup, documentation comments, TODO quality, and reducing narration. Do not use when the requested change modifies logic.

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

KodekaTeam/superior-skills23Updated Oct 29, 2026

Write or revise user-facing product and marketing copy with a specific voice, verifiable claims, natural rhythm, and useful actions. Use for interface labels, onboarding, landing pages, help text, and product messaging. Do not use for code comments or neutral technical documentation unless tone editing is requested.

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

KodekaTeam/superior-skills23Updated Oct 29, 2026

See all skills by KodekaTeam

Report a problem with this skill