Skip to content
cccskills
FreePublished on GitHub

shift-docs

Route Shift documentation, architecture notes, and tickets correctly. Use when Codex is about to create or move docs, write an architecture plan, capture a design decision, create a ticket, or update repo documentation for Shift.

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

Works withObsidian
See how to install

Files included (2)

  • SKILL.md1.1 KB
  • agents/openai.yaml229 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Shift Docs

Use the right destination for the artifact.

Routing

  • Stable repo documentation belongs in docs/ or the module's canonical DOCS.md, following docs/architecture/index.md.
  • Tickets, design scratchpads, future-work plans, and exploratory architecture proposals do not belong in repo docs/.
  • Put tickets and exploratory plans in Obsidian under ~/Documents/KostyaVault/projects/shift/, or open a GitHub issue when the user asks for a tracked issue.
  • Do not create CONTEXT.md files.

Before Writing

  1. Read docs/architecture/index.md when changing stable repo documentation.
  2. If the artifact is a ticket, plan, or unresolved proposal, route it to Obsidian or GitHub instead of docs/.
  3. If unsure whether something is stable documentation or a ticket, ask briefly before writing.

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

commit

Free

Canonical rules for writing git commits in the Shift codebase. Use whenever the user asks to commit, stage and commit, create a pull request that requires commits, or draft a commit message. Enforces Conventional Commits, release-note quality, concise subjects, and logical commit boundaries.

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

shift-editor/shift359Updated Oct 19, 2026

Find and remove dead code (unused files, exports, class members) using Knip as a candidate generator, then verify each candidate through AST-level analysis and interface tracing before removing anything. Use when the user asks to clean up unused code, find dead code, or reduce the codebase.

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

shift-editor/shift359Updated Oct 19, 2026

docs

Free

Update or create DOCS.md files for Shift subsystems. Use this skill whenever the user asks to update docs, refresh documentation, create a DOCS.md, write module documentation, or says "update docs for X". Also trigger after completing a large feature when Claude.md says to update docs — check if any DOCS.md in the affected subsystem needs refreshing.

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

shift-editor/shift359Updated Oct 19, 2026

Adversarially fact-check DOCS.md files against the actual source code, verifying every concrete claim rather than trusting structure checks. Use when the user asks to audit docs, verify documentation accuracy, check whether docs are still true, or on a scheduled documentation review. This is the semantic layer the mechanical checkers cannot cover.

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

shift-editor/shift359Updated Oct 19, 2026

issue

Free

Canonical rules for finding, creating, and updating Shift GitHub issues. Use whenever the user asks to file, create, open, update, triage, or search for an issue, or when substantial work needs an issue before a pull request. Prevents duplicates and defines acceptance criteria and pull-request closure semantics.

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

shift-editor/shift359Updated Oct 19, 2026

jsdoc

Free

Add or revise source-level JSDoc for Shift APIs. Use this skill before writing or editing documentation comments for exported classes, methods, constructors, domain data structures, render frames, reactive state, or any API where caller intent, side effects, lifetime, ownership, or nullability are easy to misunderstand.

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

shift-editor/shift359Updated Oct 19, 2026

See all skills by shift-editor

Report a problem with this skill