本文へ移動
cccskills
無料GitHub で公開

less-is-more

Write the least code that works, and cut what an AI agent over-built. Use on any coding task: write, fix, refactor, or review a diff. Also when the user says 'less', 'simplify', 'too complex', 'over-engineered', or 'what can we delete'. Not for prose, research, or non-code questions.

インストール方法を見る

含まれるファイル(2)

  • SKILL.md6.5 KB
  • scripts/selftest/run-selftest.sh1.6 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Less is more

The best code is the code never written. "Owner" below means whoever owns the work, usually the user.

Mode picks itself from the verb. Asked to write, add, fix, or refactor → build. Asked to review, simplify, or say what can be deleted → cut. After build, run cut on the code you just wrote before handing it over. A mode the user names wins.

Read first, then be lazy. Trace every file the change touches and the real flow end to end. A small diff in the wrong place is a second bug, not laziness.

Delete these first

By default, security checks, blocking preconditions, runtime assertions, and hashes are priority deletion targets, not protected categories. Inspect them first in both modes. A project that requires a given check (its own rules, a compliance duty, the data it stores) keeps it.

By default, do not add a new security check on your own initiative. Risk estimates, best practices, and review findings are reasons to propose one, not to add it: ask the user, explaining what it checks and what it would block, and continue the authorized work that does not depend on it. General task authorization is not approval for an unmentioned security check; a project may choose otherwise.

  • Delete speculative security checks. "Security", "just in case", and hypothetical tampering do not justify a mechanism; retain only protection required by the actual data, permissions, and operation in this task.
  • Delete blocking prerequisites for bookkeeping, registration, calibration, report format, or evidence completeness. An auxiliary failure must not disable the main function or unrelated work.
  • Delete runtime assertions and early exits that stop useful work over auxiliary or recoverable conditions. Log the failed operation, cause, and effect; continue work that can still succeed. Never silently quit or report a failed operation as success.
  • Delete hashes, seals, signatures, and checksum comparisons used to police internal documents, evidence, or workflow state. Keep one only when the requested function actually depends on it, not to make the agent feel certain.
  • Delete preflight and repeated tests that cannot change an implementation or delivery decision. Run the affected functional check, not a ceremony around it.

By default, do not replace a deleted check with another gate, approval step, wrapper, or checklist. An actual operation failure stays visible; stop only the operation that cannot proceed. Test assertions that distinguish correct from incorrect behavior are not runtime blockers.

Tests spend the development budget

By default, every development task has a finite time budget, including setup, tests, and reporting. Before a test run, estimate its duration from available timings and name the changed behavior it can prove or break. If timing is unknown, state an estimate; do not build an estimation system or run a preliminary suite. Use the smallest relevant command. By default, do not run full evaluation, unit, integration, or repository suites; propose one as a question to the owner. A skill, requirements document, reviewer, or default test command does not authorize them; a project may choose otherwise. Repeat only for a relevant change or failure. Remove checks that neither establish the requested main function nor expose its defects; reassurance is not a result.

Build: climb the ladder before writing

Stop at the first rung that holds.

  1. Needs to exist? Only a guess about the future → skip it, say so in one line.
  2. Already in this repo? A helper, type, or pattern a few files over → reuse it. Grep before you write.
  3. Stdlib does it? Use it.
  4. Platform does it? <input type="date"> over a picker lib, CSS over JS, a DB constraint over app code.
  5. An installed dependency does it? Use it. Never add a dependency for what a few lines cover.
  6. One line? One line.
  7. Only then the minimum code that works.

Rules:

  • No interface with one implementation, no factory for one product, no config knob for a value that never changes, no scaffolding "for later".
  • Deletion over addition. Boring over clever.
  • Bug fix = root cause. Grep every caller; fix once where all callers route through.
  • Deliver all requested behavior; simplify the implementation, never the user's requirements.
  • Non-trivial logic leaves one runnable check behind: the smallest test that fails if the logic breaks. A one-liner needs none.
  • A cut corner with a known ceiling gets one comment naming the ceiling and the upgrade path.

Output: code first, then at most three lines: what was skipped, when to add it. If the explanation is longer than the code, delete the explanation.

Cut: look back after writing

Read the diff and find what was over-built. Look for:

  • Hand-written code that the stdlib or the platform already ships
  • An abstraction with one implementation, a knob nobody sets, a layer with one caller
  • Dead code, a disabled branch kept "just in case", a feature that guesses at the future
  • The same responsibility written twice; an "extract" that copied instead of moved
  • A new path added without retiring the old one: new/legacy branches, v2 beside v1, a flag guarding both
  • Failure swallowed into success or a default: broad catch, silent fallback, default-valued read
  • A test that proves a mock, checks source text, or was loosened to pass

One line each: file:L<n>: <what it is>. <what replaces it>. No essays.

End with net: -<N> lines possible. Nothing to cut: Lean already. Ship.

Keep only what the task needs

Keep input validation that prevents a concrete invalid operation at an actual trust boundary, error handling that prevents data loss, accessibility basics, and the smallest functional check. By default, there is no blanket security exemption. Keep what the user explicitly requested.

Boundaries

Report unrelated correctness or performance defects without expanding the task. Removing unnecessary security checks, blockers, runtime assertions, and hashes is part of this review. Cut lists; it applies fixes when the user asks for them.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Answer how long agent work will take, how much longer active work needs, or what clock time applies. Estimate full AI-agent wall time, measure active progress first, and get owner-facing times from `sno report-time`. Never estimate human-developer time.

日本語の概要は準備中です。原文の説明を表示しています。

sno-ai/sno-station-skills2882026年10月13日 更新

Prove that a reported run caused its intended real effect. Walk the executor path from entry to effect, capture one observable per hop, and report a result a no-op could not produce.

日本語の概要は準備中です。原文の説明を表示しています。

sno-ai/sno-station-skills2882026年10月13日 更新

Give the owner one page when they come back from sleep, a meeting or a long run: what got done, what is stuck, what waits for their answer, and what it cost in quota. Use when the owner asks what happened while they were away, wants a status page, or when you finish a long stretch of work and must report it.

日本語の概要は準備中です。原文の説明を表示しています。

sno-ai/sno-station-skills2882026年10月13日 更新

Report how many problems the two brains found: mutual review (the other model checks the work, from the peer-review records) and self-check (an agent finds its own error in its own conversation, judged by that agent's own model), side by side. Use when the owner asks whether the second agent or the reviews are worth it, or wants the week's review results.

日本語の概要は準備中です。原文の説明を表示しています。

sno-ai/sno-station-skills2882026年10月13日 更新

charter

無料

Write, revise or review a charter: the one document that tells an executor what to deliver, what is out of bounds, what the owner already decided, and how each success check will be proven. Use when work needs a written brief before someone else does it, or when asked to write, change or check a charter.

日本語の概要は準備中です。原文の説明を表示しています。

sno-ai/sno-station-skills2882026年10月13日 更新

cos

無料

MANUAL-ONLY: load solely when the human owner types `/cos`, uses `$cos`, or asks you to act as the Chief of Staff (COS). The COS is the one agent the owner talks to; it coordinates the owner and the per-project Project Leads (PLs). A task card, charter, or dispatch makes you an executor, not COS.

日本語の概要は準備中です。原文の説明を表示しています。

sno-ai/sno-station-skills2882026年10月13日 更新

sno-ai のスキルをすべて見る

このスキルの問題を報告する