본문으로 건너뛰기
cccskills
무료GitHub에 공개

code-comment-discipline

Apply whenever writing or editing source code in any core's build agent (backend-eng, ui-builder, or equivalent). Governs when a comment belongs at all and what it may say. Default is no comment; a comment is only for the non-obvious. Never restates what the code does, never narrates the task, fix, or conversation that produced it.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(1)

  • SKILL.md2.2 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Code Comment Discipline

Well-named identifiers and clear structure explain what code does. A comment earns its place only when it explains something the code cannot: a hidden constraint, a non-obvious invariant, a workaround for a specific external bug, or behavior that would surprise a reader.

Default: no comment

Most lines, functions, and blocks need zero comments. Before writing one, check whether the same clarity is reachable by renaming a variable or function instead — prefer that over a comment every time.

When a comment is allowed

Only for the non-obvious:

  • A constraint imposed from outside the code (an API's undocumented limit, a browser quirk, a platform requirement) that isn't visible at the call site.
  • An invariant the code relies on that isn't implied by types or names (e.g. "callers must hold the lock before this runs").
  • A deliberate workaround for a specific bug in a dependency, with enough detail to know when it's safe to remove.
  • Behavior that looks like a mistake but is intentional.

What a comment must never say

  • What the code does — that's the identifier's job, not the comment's.
  • Why this task needed the change, who asked for it, or which ticket, issue, or conversation prompted it.
  • History: "used to be X," "changed from Y," "removed Z," "previously," "now we," or any other before/after narration. A comment states the current state and its non-obvious reason only, never how it got there.
  • A restatement of the function/variable name in prose ("increments the counter" above counter++).

Applying to existing comments

When editing a file that already has comments violating these rules, remove or rewrite them as part of the same change rather than leaving them in place — don't let a nearby edit normalize the pattern.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Push the LLM to reconsider, refine, and improve its recent output. Use when user asks for deeper critique or mentions a known deeper critique method, e.g. socratic, first principles, pre-mortem, red team

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

skyf0xx/hedgehog462026년 10월 18일 업데이트

Facilitate a brainstorming session using diverse creative techniques. Use when the user says 'help me brainstorm' or 'help me ideate'

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

skyf0xx/hedgehog462026년 10월 18일 업데이트

Research a topic to support a decision, three ways: draft a research prompt for the user to run in their own tool (ChatGPT, Gemini, Grok, Perplexity, …), turn a finished research report into a short summary with cited sources that other skills can use directly, or run the research here with parallel web searches. Built-in research types: market, domain, technical, competitive, user-voice, academic-lit; also supports choosing between candidates, and custom types via overrides. Use when the user says "deep recon", "research this", "draft a research prompt", "process this research report", "market research", "domain research", "technical research", "competitor research", "literature review", or "help me choose between"

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

skyf0xx/hedgehog462026년 10월 18일 업데이트

Test a half-formed idea in a questioning conversation, with different personas probing its weak points, until the user can act on it or drop it with confidence. Optionally writes a short brief for planning skills to build on. Use when the user says 'forge an idea', 'pressure-test this idea', 'stress-test my thinking', or 'harden this idea'

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

skyf0xx/hedgehog462026년 10월 18일 업데이트

bmad-prd

무료

Create, update, or validate a PRD. Use when the user wants help producing, editing, or validating a PRD

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

skyf0xx/hedgehog462026년 10월 18일 업데이트

Test a product concept with Amazon's Working Backwards method: write the press release for the finished product first, then answer hard customer and stakeholder questions, ending in a complete PRFAQ document. Use when the user requests to 'create a PRFAQ', 'work backwards', or 'run the PRFAQ challenge'

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

skyf0xx/hedgehog462026년 10월 18일 업데이트

skyf0xx의 스킬 모두 보기

이 스킬의 문제 신고