- name
SKILL.md
스킬 파일은 게시자의 저장소에 그대로 있습니다.
복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add notque/vexjoy-agent --skill comment-quality -a cursor -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add notque/vexjoy-agent --skill comment-quality -a claude-code -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add notque/vexjoy-agent --skill comment-quality -a codex -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add notque/vexjoy-agent --skill comment-quality -a grok -y복사한 메시지를 Grok Bot 채팅에 보냅니다. Bot이 GitHub에서 이 SKILL.md를 가져와 모든 Bot이 공유하는 스킬에 추가합니다.
Install this skill: https://github.com/notque/vexjoy-agent/tree/HEAD/skills/code-quality/comment-quality게시자 제공
Review code comments for temporal references, development-activity language, and relative comparisons. Produces structured reports with actionable rewrites that explain WHAT the code does and WHY, only WHAT the code does and WHY. Supports .go, .py, .js, .ts, .md, and .txt files.
Goal: Identify all comments containing temporal, activity, or relative language.
Step 1: Determine scope
Read the repository CLAUDE.md first to pick up any project-specific comment conventions.
Scan only what was requested. If user specifies files, scan those files. If user specifies a directory, scan that directory. Honor the explicit scope -- even if you suspect other files have issues, honor the explicit scope and suggest expansion separately at the end.
If user explicitly requests auto-fix, enable it. Otherwise present findings for review. For large codebases, group findings by directory when reporting.
Step 2: Search for temporal patterns
Flag every instance of the following categories. No temporal word is "harmless" -- all temporal language ages poorly and must be rewritten regardless of how innocuous it seems:
Step 3: Filter false positives
Exclude from findings -- these are not developer comments and must remain untouched:
@generated markers (tooling markers)@deprecated annotations (keep the tag, flag only temporal explanation text after it)When a finding appears, inspect nearby comments in the same function or block -- temporal language tends to cluster.
Gate: All files in scope scanned. Findings list populated with file path, line number, and matched text. Every finding listed, not just the first few. Proceed only when gate passes.
Goal: Understand context for each finding to produce meaningful rewrites.
Step 1: Read surrounding code
For each finding, read the function, block, or section the comment describes. Understand what the code actually does. A rewrite without code context produces vague replacements that strip temporal words without adding substance.
Step 2: Classify the comment
| Finding | Type | Severity |
|---------|------|----------|
| "now uses JWT" | Temporal + Activity | High |
| "improved perf" | Activity | Medium |
| "Copyright 2024" | Legal (skip) | N/A |
Step 3: Determine replacement content
For each comment, identify:
Gate: Every finding classified with context understood. Proceed only when gate passes.
Goal: Generate specific, valuable replacement comments.
Step 1: Draft rewrites
For each finding, produce a structured entry with file path, line number, current text, suggested replacement, and reasoning:
**File: `path/to/file.ext`**
Line X - [Comment type]:
Current: // Authentication now uses JWT tokens
Suggested: // Authenticates requests using signed JWT tokens
Reason: "now uses" is temporal - describe current behavior only
Step 2: Validate rewrite quality
Each rewrite MUST pass these checks:
If a rewrite just removes the temporal word without adding substance, it fails validation. Simply deleting a word produces a useless comment -- // Updated error handling becoming // Error handling adds nothing. Rewrite with specific, descriptive content: // Handles database connection errors with exponential backoff retry.
Gate: All rewrites pass quality checks. No vague or empty replacements. Proceed only when gate passes.
Goal: Deliver structured, actionable report.
Step 1: Generate report
Report facts concisely with file paths and line numbers. Every finding must include the current text, suggested replacement, and reasoning -- a diagnostic-only count without rewrites creates work without providing solutions.
## Comment Quality Review
### Summary
- Files scanned: N
- Issues found: M
- Most common pattern: [temporal word]
### Findings
[All findings with file, line, current text, suggested text, reason]
### Recommendations
1. Apply suggested changes
2. Consider adding linter rules for temporal language prevention
Step 2: Apply fixes (if auto-fix enabled)
If user requested auto-fix, apply all rewrites using Edit tool. Verify each edit succeeded. Wait for explicit user permission before auto-fixing without explicit user authorization.
Step 3: Cleanup
Remove any scan results, intermediate reports, or helper files created during execution.
Gate: Report delivered. All findings accounted for. Task complete.
Cause: Files are clean or scope was too narrow Solution:
Cause: Large codebase with widespread temporal language Solution:
Cause: Comment only makes sense with development context that no longer exists Solution:
Load on demand when the current task matches the signal.
Review and fix temporal references in code comments.
---name: comment-qualitydescription: Review and fix temporal references in code comments.---# skills/code-quality/comment-quality/SKILL.mdFAQ
게시자에게서 skills/code-quality/comment-quality/SKILL.md를 다운로드하거나 경로를 복사해 저장소를 엽니다. PlugMCP는 스킬을 목록에 올릴 뿐 파일을 호스팅하지 않습니다.
게시자가 https://github.com/notque/vexjoy-agent에서 관리합니다.
Claude, Cursor, Codex, Grok Build는 게시자의 저장소에서 추가한 SKILL.md를 읽을 수 있습니다. Grok Bot은 채팅에서 스킬의 GitHub 폴더 링크를 보내면 설치합니다.