메뉴
Run this repo's documentation and shell quality gates (shellcheck, markdownlint, lint-claude-md) the same way CI runs them. Invoke before opening a PR, or when the user asks to lint, validate, or pre-flight the docs.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | lint-docs |
| description | Run this repo's documentation and shell quality gates (shellcheck, markdownlint, lint-claude-md) the same way CI runs them. Invoke before opening a PR, or when the user asks to lint, validate, or pre-flight the docs. |
| allowed-tools | Bash(shellcheck:*), Bash(markdownlint:*), Bash(bash tools/lint-claude-md.sh:*), Bash(find:*), Bash(git status:*), Read |
Run the same three checks CI runs and report pass/fail per check.
.sh under the repo and run shellcheck on it.
find . -name '*.sh' -not -path './.git/*' -print0 | xargs -0 shellcheck
markdownlint on README.md, CONTRIBUTING.md,
CHANGELOG.md, and everything under guides/, examples/, plugins/,
tools/hooks/. Use .markdownlint.json at repo root.bash tools/lint-claude-md.sh against every
examples/claude-md-*.md template and the repo's own CLAUDE.md.Print a single summary table, one row per check:
| Check | Status | Details |
|---|
If any check fails, print the first 20 lines of its output below the table and stop. Do not try to auto-fix unless the user asks.
shellcheck or markdownlint isn't installed, say so and skip that
check — don't silently pass.Scaffold a new HTTP handler with service function, store method (if needed), and table-driven test, following the project's internal/{api,service,store} layout. Invoke when the user asks to add an endpoint, handler, or route.
Scaffold a new API endpoint with request/response Pydantic schemas, service function, route handler, and a pytest test — following the project's layered layout. Invoke when the user asks to add an endpoint, route, or API method.
Scaffold a new React component with matching test file and consistent folder layout, following the project's conventions in src/features or src/components. Invoke when the user asks to create, scaffold, or add a new component.
Write React Testing Library tests for an existing component, following the project's RTL conventions (prefer role/label queries, mock at network boundary, no act()). Invoke when the user asks to test, add tests for, or cover a component.
Generate or update CHANGELOG.md with an entry for the unreleased changes since the last git tag. Invoke when the user asks to cut a release, update the changelog, or summarize changes since v-something.
Write a pull-request title and body from the current branch's commits and diff against the base branch. Invoke when the user asks to open a PR, draft a PR description, or summarize a branch.