check-comments

Name: check-comments
Author: CodeAny-inc

Scan Clavyn source for history/attribution comments that should be documentation instead. Use after writing or editing code to catch and fix violating comments before committing.

by CodeAny-inc(0) 0 installs

Free

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Instruction file imported from CodeAny-inc/Clavyn (.cursor/rules/check-comments.mdc). Copyright stays with the author.

Comment hygiene for Clavyn

The canonical Agent Skill lives at .agents/skills/check-comments/SKILL.md (standard agentskills.io location). This Cursor rule is a thin pointer so Cursor's rules discovery finds it.

Quick reference

node scripts/verify/check-comments.mjs --pretty     # scan tracked source
node scripts/verify/check-comments.mjs --staged     # only staged files
node scripts/verify/check-comments.mjs <path>       # scan a path

Full instructions

Read .agents/skills/check-comments/SKILL.md for the full rule, the fix workflow, escape hatches, and gotchas. See AGENTS.md "Comment hygiene (enforced)" for the policy. Fix every finding before committing.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

codeany-inc-clavyn-check-comments-rule.ocm.jsonjson

{
  "ocm": "1",
  "id": "codeany-inc-clavyn-check-comments-rule",
  "kind": "skill",
  "name": "check-comments",
  "description": "Scan Clavyn source for history/attribution comments that should be documentation instead. Use after writing or editing code to catch and fix violating comments before committing.",
  "publisher": "CodeAny-inc",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "github-cursor-rules"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Scan Clavyn source for history/attribution comments that should be documentation instead. Use after writing or editing code to catch and fix violating comments before committing."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github-cursor-rules",
      "repository": "https://github.com/CodeAny-inc/Clavyn",
      "path": ".cursor/rules/check-comments.mdc",
      "ref": "ec7b676b07385471f64d506dec730c20558f9885",
      "url": "https://github.com/CodeAny-inc/Clavyn/blob/ec7b676b07385471f64d506dec730c20558f9885/.cursor/rules/check-comments.mdc",
      "key": "CodeAny-inc/Clavyn/.cursor/rules/check-comments.mdc"
    },
    "applies_to": [
      "desktop/src/**/*",
      "desktop/src-tauri/src/**/*",
      "core/src/**/*",
      "scripts/verify/**/*",
      ".agents/skills/check-comments/**/*"
    ]
  },
  "instructions": "# Comment hygiene for Clavyn\n\nThe canonical Agent Skill lives at `.agents/skills/check-comments/SKILL.md`\n(standard agentskills.io location). This Cursor rule is a thin pointer so\nCursor's rules discovery finds it.\n\n## Quick reference\n\n```bash\nnode scripts/verify/check-comments.mjs --pretty     # scan tracked source\nnode scripts/verify/check-comments.mjs --staged     # only staged files\nnode scripts/verify/check-comments.mjs <path>       # scan a path\n```\n\n## Full instructions\n\nRead `.agents/skills/check-comments/SKILL.md` for the full rule, the fix\nworkflow, escape hatches, and gotchas. See `",
  "cost": {
    "context_tokens": 173
  }
}

Fetch it by URL: GET /api/v1/registry/codeany-inc-clavyn-check-comments-rule/manifest?version=1.0.0