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.

Jump to install

Repository: shift-editor/shift
Last source activity: July 5, 2026 at 14:20
Detected SKILL.md language: English
Stars: 244
Forks: 7

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/shift-editor/shift --skill shift-docs

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

docs-audit

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.

2026-08-19

docs

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.

2026-08-19

commit

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.

2026-08-18

View all from this repository

name	shift-docs
description	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.

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

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

shift-docs

Source facts

Install options

Review the source files

More from this repository

More from this repository

Shift Docs

Routing

Before Writing

Shift Docs

Routing

Before Writing