comment-mode
Granular feedback on drafts without rewriting. Generates highlighted HTML with click-to-reveal inline comments. Use when user says "comment on this", "leave comments on", "give feedback on", or asks for feedback on a draft. Supports multiple lenses—editor feedback, POV simulation
供给资产档案
编程与开发 Agent
代码审查、仓库分析、测试、CI、GitHub、DevOps 与开发工作流 Skill。
场景
GitHub automation
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
适配 Agent
Claude Code + Cursor + Browser agents
适用于 Codex、Claude Code、Cursor、CLI 或自定义 Agent。
安装
就绪
npx skills add shipshitdev/skills --skill comment-mode
维护状态
新鲜
距上次推送 3 天
风险
需审查
许可证不清晰
GitHub 质量
33
57/100 质量 · 66/100 信任
覆盖标签
审查说明
许可证不清晰 · Permission surface may require sandboxing
Agent 采用评分卡
一眼查看信任、审计与安装准备度
这些分数综合公开仓库元数据、OpenAgentSkill 审查信号、维护新鲜度与安装准备度。它用于候选筛选，不替代人工审查。
质量
有潜力有用的候选项，但采用前应与替代方案比较。
信任
Do not auto-installTrust Score v5 found insufficient evidence for agent installation. Treat this as discovery material, not an executable recommendation.
审计
需审查对安装准备度、安全元数据、维护情况与采用风险的机器可读审查。
OpenAgentSkill 信任评分 v5
安装前需人工审查
Choose a stronger alternative or inspect the source manually before any install attempt.
Stars
33 个 GitHub Stars
仓库活跃度
33 个 Star，3 个 Fork
维护状态
距上次推送 3 天
许可证
未知
安装
npx skills add shipshitdev/skills --skill comment-mode
安装安全性
标准软件包或运行时安装路径
权限范围
shell or command execution, filesystem or document access
Agent 结果
暂未有 Agent 结果数据
文档
README/SKILL.md 上下文充分
风险摘要
生产前审查
- Repository license detected as Unknown, though plugin.json declares MIT. This mismatch may cause compliance ambiguity.
- Financial research output is not financial advice; require human review before any live investment decision.
- 许可证不清晰
- Low GitHub adoption signal
安装准备度
安装路径可用
- 安装路径可用
- 仓库证据可用
- 许可证不清晰
- 暂无 Agent 验证结果证据
Agent 可读元数据
这个 Skill 的机器可读决策数据。
使用此区块或内嵌 JSON 判断 Agent 是否应安装该 Skill、选择替代方案，或先请求人工审查。
适用任务
- GitHub automation 工作流
- Claude Code 团队
- builders willing to evaluate younger projects
- Inspect repository metadata
适用 Agent
安装决策
- 命令
- npx skills add shipshitdev/skills --skill comment-mode
- 策略
- 审查
- 人工审查
- 是
信任与风险
- 信任
- 58/100
- 审计
- 71/100
- 风险级别
- 需审查
结果闭环
- 端点
- /api/agent/outcome
- 事件 ID
- resolve
- 结果
- 5
不适用场景
- 需要厂商支持 SLA 的团队
- production agents without a repository review
- Low GitHub adoption signal
- Repository license detected as Unknown, though plugin.json declares MIT. This mismatch may cause compliance ambiguity.
- 暂未有 OpenAgentSkill 使用反馈数据
Agent 安全 v2
39/100 · 避免自动安装
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
高
Shell 或命令执行
Skill 元数据引用了终端、CLI、Shell、子进程或命令执行工作流。
中
Browser automation
Skill may drive a browser or interact with web pages.
中
网络访问
Skill 可能访问远程页面、API、仓库或外部服务。
中
文件系统访问
Skill 可能读取或写入项目文件、文档、生成产物或本地工作区状态。
- 高风险权限提示：Shell 或命令执行
- 许可证不清晰
安装目标
在你的 Agent 工作流中安装此 Skill
通过公开安装端点获取命令、安全清单、目标提示词和该 Skill 的规范链接。
OpenAgentSkill CLI
Resolve policy, run the source installer safely, and report a verified install receipt.
$ npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install shipshitdev-comment-modeAgent 解析计划
让 Agent 在安装前验证匹配度。
Resolve API 返回首选 Skill、替代方案、安全策略、审计说明、安装目标和可直接执行的提示词，无需抓取此页面。
打开 JSON
/api/agent/resolve?task=Use%20comment-mode%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve 文本
/api/agent/resolve?task=Use%20comment-mode%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
安装交接
/api/skills/shipshitdev-comment-mode/install
Agent 应检查
- 从 Resolve API 检查任务匹配与替代方案。
- 检查审计评分、信任评分和安全策略警告。
- 检查 Codex、Claude Code、Cursor 或 CLI 的安装目标兼容性。
复制提示词
Task: Use comment-mode in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20comment-mode%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/shipshitdev-comment-mode/install
Install command: npx skills add shipshitdev/skills --skill comment-mode
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent 交接
把安装路径交给 Agent，而不是再给一个目录页。
通过公开安装端点获取命令、安全清单、目标提示词和该 Skill 的规范链接。
安装交接
/api/skills/shipshitdev-comment-mode/install
LLM 文本格式
/api/skills/shipshitdev-comment-mode/install?format=text
寻找替代方案
/api/skills/search?q=comment-mode&limit=3
Agent 提示词
Use comment-mode for this task. Review https://www.openagentskill.com/api/skills/shipshitdev-comment-mode/install, then install with: npx skills add shipshitdev/skills --skill comment-modeRegistry 元数据
用于自动选择 Skill 的 Agent 可读档案。
本页通过 Registry API 提供相同的决策、信任、审计、场景和安装信号，让 Agent 无需抓取界面即可排序。
Manifest
/api/registry/manifest/shipshitdev-comment-mode
LLM 文本
/api/registry/manifest/shipshitdev-comment-mode?format=text
安装别名
/api/registry/install/shipshitdev-comment-mode
推荐
/api/registry/recommend?task=Use%20comment-mode%20in%20an%20agent%20workflow&limit=3
适配 Agent
GitHub automation
平台
Claude Code, Cursor, Browser agents
Agent 决策面板
Needs validation for GitHub automation
在将它加入 Agent 工作流前先人工审查仓库。
栈中角色
需要验证
主要匹配
GitHub automation
信任标签
需要人工审查
安装路径
命令已就绪
适用场景
- GitHub automation 工作流
- Claude Code 团队
- builders willing to evaluate younger projects
证据
- 仓库近期活跃
- 已提供安装命令或 GitHub 仓库
- 57/100 质量档案
先审查
- Low GitHub adoption signal
- Repository license detected as Unknown, though plugin.json declares MIT. This mismatch may cause compliance ambiguity.
- 暂未有 OpenAgentSkill 使用反馈数据
实施路径
- 1在沙盒 Agent 中安装它，并端到端完成一次GitHub automation任务。
- 2Compare output quality, latency, and failure behavior against at least one alternative.
- 3Promote it into production only after reviewing repository permissions, license, and maintenance signals.
信任档案
Do not auto-install
Trust Score v5 found insufficient evidence for agent installation. Treat this as discovery material, not an executable recommendation.
GitHub 采用度
检查33 个 GitHub Stars
Star/Fork 活跃度
检查33 个 Star，3 个 Fork; 当前元数据中没有议题活跃度信息
近期维护
通过距上次推送 3 天
许可证清晰度
检查未知
积极信号
- AI 审查已通过
- 安装路径可用
- 仓库证据可用
- 近期维护的仓库
- 安装命令未发现明显高风险模式
- 结果闭环已就绪，但需要首次真实 Agent 运行
安装前审查
- Repository license detected as Unknown, though plugin.json declares MIT. This mismatch may cause compliance ambiguity.
- Financial research output is not financial advice; require human review before any live investment decision.
- 许可证不清晰
- Low GitHub adoption signal
- Quality score needs review
- Permission surface needs review: shell or command execution, filesystem or document access
- GitHub adoption: 33 GitHub stars
- Stars/forks activity: 33 stars, 3 forks; issue activity unavailable in current metadata
- License clarity: Unknown
- Permission surface: shell or command execution, filesystem or document access
- 暂未有真实 Agent 结果报告
- 无人值守安装前需要人工审查
建议操作
Choose a stronger alternative or inspect the source manually before any install attempt.
质量档案
有潜力 适用于 Agent 工作流的候选
有用的候选项，但采用前应与替代方案比较。
工作流匹配
在这些场景使用此 Skill
Manage repositories
GitHub automation
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Collect structured data
Web scraping
I need my agent to scrape websites and extract structured data from pages.
Build and ship code
Coding agents
I need a coding agent that can understand a repository, edit code, and review pull requests.
工作流匹配
加入完整工作流
Scrape, clean, and reuse web data
Web data pipeline
A practical workflow for agents that crawl public pages, extract clean content, normalize data, and hand it to downstream research or RAG workflows.
Turn skills into distribution
Content growth agent
A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.
Ingest, retrieve, and cite
RAG knowledge base
A workflow for document-heavy agents that ingest files, create searchable knowledge, retrieve relevant context, and answer with grounded sources.
概览
--- name: comment-mode description: Granular feedback on drafts without rewriting. Generates highlighted HTML with click-to-reveal inline comments. Use when user says "comment on this", "leave comments on", "give feedback on", or asks for feedback on a draft. Supports multiple lenses—editor feedback, POV simulation ("as brian would react"), or focused angles ("word choice only", "weak arguments"). A granular alternative to rewrites that lets users review feedback incrementally without losing their voice. metadata: version: "1.0.0" tags: "feedback, comments, editing" allowed-tools: Bash(open *) Write disable-model-invocation: true ---
# Comment Mode
Generate highlighted HTML with click-to-reveal comments for granular feedback on text. Alternative to rewrites—user keeps their voice, reviews feedback incrementally.
## Contract
Inputs:
- The draft text to comment on (pasted inline or as a file path) - Optional lens: editor feedback, POV simulation (e.g. "as brian would react"), or focused angle (e.g. "word choice only")
Outputs:
- An HTML file at `_private/views/{name}-comments-temp.html` with highlighted spans and click-to-reveal comment overlays
Creates/Modifies:
- Writes `_private/views/{name}-comments-temp.html`
External Side Effects:
- Runs `open _private/views/{name}-comments-temp.html` to launch the file in the default browser
Confirmation Required:
- None — the file is a temp view artifact in `_private/` and does not modify source files
Delegates To:
- None.
## When to Use
- User says: "comment on this", "leave comments on", "give feedback on" - User pastes text and asks for feedback/critique - User wants targeted feedback without a full rewrite
## Clarify Before Commenting
Use AskUserQuestion to clarify scope when the request is ambiguous. Avoid over-commenting (overwhelming) or under-commenting (missing the point).
**Clarify when:**
- No lens specified → ask what angle they want - Long document → ask if they want full coverage or just key sections - Unclear audience → ask who the recipient is (affects POV comments)
**Skip clarification when:**
- Lens is explicit ("comment on word choice only") - Document is short (<500 words) - Context is obvious from conversation
**Example clarification:**
``` User: "comment on this" [long doc, no lens specified]
→ Use AskUserQuestion: "What should I focus on?" Options: - "Editor feedback (structure, clarity, word choice)" - "Recipient POV (how [person] would react)" - "Specific angle (tell me what)" ```
## Lenses
| Lens | Color | Comment style | |------|-------|---------------| | Editor | Yellow (#fff3cd) | observations, suggestions: "weak opener", "add proof here" | | POV (as person) | Blue (#e3f2fd) | reactions from that person's perspective: "i know this already", "legal would freak out" | | Focused | Yellow | specific angle only: "word choice", "tone", "weak arguments" |
## Comment Style
- Always lowercase - Short (5-15 words) - Smart about type: observations when noting, suggestions when alternatives help, reactions when simulating POV - Only comment where there's something worth saying—sparse beats exhaustive
## Output Rules
**DO:**
- Write to `_private/views/{name}-comments-temp.html` - Open with `open _private/views/{name}-comments-temp.html` - Use highlight colors matching the lens - Keep comments sparse and high-signal
**DO NOT:**
- Comment on everything—only where there's an obvious edit or insight - Over-explain in comments—keep them punchy - Mix lenses in one output—pick one and stick to it
## Template
```html <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>{title}</title> <style> * { box-sizing: border-box; } body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; max-width: 700px; margin: 0 auto; padding: 40px 20px; line-height: 1.7; color: #1a1a1a; background: #fafafa; } h1, h2, h3 { margin-top: 2em; font-weight: 600; } h1 { font-size: 1.4em; } h2 { font-size: 1.2em; color: #333; } p { margin: 1em 0; }
.highlight { background: {highlight-bg}; /* #fff3cd yellow for editor, #e3f2fd blue for POV */ padding: 1px 4px; border-radius: 3px; cursor: pointer; border-bottom: 2px solid {highlight-border}; /* #ffc107 for editor, #2196f3 for POV */ transition: background 0.15s; } .highlight:hover, .highlight.active { background: {highlight-hover}; /* #ffe69c for editor, #bbdefb for POV */ }
.comment { display: none; background: {comment-bg}; /* #1a1a1a for editor, #0052cc for POV */ color: #fff; padding: 8px 12px; border-radius: 6px; font-size: 0.85em; margin: 8px 0; line-height: 1.5; } .comment.show { display: block; }
.section-break { border: none; border-top: 1px solid #ddd; margin: 2em 0; }
.legend { position: fixed; bottom: 20px; right: 20px; background: #fff; padding: 12px 16px; border-radius: 8px; box-shadow: 0 2px 12px rgba(0,0,0,0.1); font-size: 0.8em; color: #666; } </style> </head> <body>
{content with <span class="highlight" data-comment="comment text">highlighted phrase</span>}
<div class="legend">{count} comments · click highlights to reveal</div>
<script> document.querySelectorAll('.highlight').forEach(el => { const commentText = el.getAttribute('data-comment'); const commentDiv = document.createElement('div'); commentDiv.className = 'comment'; commentDiv.textContent = commentText; el.insertAdjacentElement('afterend', commentDiv);
el.addEventListener('click', () => { const wasActive = el.classList.contains('active'); document.querySelectorAll('.highlight').forEach(h => h.classList.remove('active')); document.querySelectorAll('.comment').forEach(c => c.classList.remove('show')); if (!wasActive) { el.classList.add('active'); commentDiv.classList.add('show'); } }); }); </script> </body> </html> ```
### Color Reference
**Editor lens (yellow):**
```css .highlight { background: #fff3cd; border-bottom: 2px solid #ffc107; } .highlight:hover, .highlight.active { background: #ffe69c; } .comment { background: #1a1a1a; } ```
**POV lens (blue):**
```css .highlight { background: #e3f2fd; border-bottom: 2px solid #2196f3; } .highlight:hover, .highlight.active { background: #bbdefb; } .comment { background: #0052cc; } ```
## Workflow
1. User pastes text + asks for comments 2. **If ambiguous**: Use AskUserQuestion to clarify lens/scope 3. Read text, identify key phrases worth commenting on (sparse, high-signal) 4. Generate HTML with highlights and `data-comment` attributes 5. Write to `_private/views/{name}-comments-temp.html` 6. Run `open _private/views/{name}-comments-temp.html`
## Examples
**Editor lens:**
``` User: "comment on this, focus on word choice" → Yellow highlights, suggestions like "vague, try 'specifically'" or "jargon, simplify" ```
**POV lens:**
``` User: "comment on this as brian would react" → Blue highlights, reactions like "i already know this" or "legal would push back here" ```
**Focused lens:**
``` User: "leave comments on this, only flag weak arguments" → Yellow highlights on weak claims, comments like "needs evidence" or "assumes too much" ```
**Sparse/sharp lens:**
``` User: "comment only where there's an obvious fix" → Minimal highlights, only typos, missing words, or clear improvements ```
技术详情
- 版本
- 1.0.0
- 许可证
- Unknown
- 最近更新
- 2026年8月23日
- 发布时间
- 2026年8月23日
决策摘要
需要验证
仓库近期活跃
Agent 验证证据
Agent 验证证据
来自解析、审查、安装和一次小范围运行后的结果报告。
- 成功率
- —
- 近期失败
- —
- 结果
- 0
- 输出质量
- —
- 失败
- 0
- 不相关
- 0
- 安装次数
- 0
- 风险拦截
- 0
- 需要配置
- 0
- 生产环境
- 0
暂时没有 Agent 结果数据。首次 Agent 执行可以通过 /api/agent/outcome 报告成功、需要设置、风险拦截、失败或不相关。
增长闭环
分享工具包
为 comment-mode 准备的场景化草稿，可手动发布到 X。
comment-mode: Granular feedback on drafts without rewriting. Generates highlighted HTML with click-to-revea... 33 stars https://www.openagentskill.com/skills/shipshitdev-comment-mode?ref=x
可选：带安装命令的回复
Listing + install path for comment-mode: https://www.openagentskill.com/skills/shipshitdev-comment-mode?ref=x Install: npx skills add shipshitdev/skills --skill comment-mode
收录来源
Registry 收录
此列表来自公开来源，维护者认领获批前不会标记为官方。
- 创作者
- shipshitdev
- 收录方
- OpenAgentSkill 社区索引
归属链接指向公开仓库或创作者主页。创作者可认领列表以更新所有权信号。
认领此 Skill所有者认领
认领此 Skill 页面
这条 Registry 收录 列表归属于 shipshitdev，但尚未标记为官方。认领后可增加已验证所有者信号，使后续发布、安装和审计更新更值得信赖。
创作者外链工具包
将证据徽章加入你的 README
在开发者评估仓库的位置展示规范页面、当前信任与审计信号，以及真实的 Agent 验证证据。
[](https://www.openagentskill.com/skills/shipshitdev-comment-mode)
[](https://www.openagentskill.com/skills/shipshitdev-comment-mode)
[](https://www.openagentskill.com/skills/shipshitdev-comment-mode/audit)
[](https://www.openagentskill.com/skills/shipshitdev-comment-mode)作者
shipshitdev
@shipshitdev
健康信号
- GitHub Stars
- 33
- 质量评分
- 34/100
- 最近 GitHub 推送
- 2026年8月20日
- 框架提示
- 未知
- OpenAgentSkill 浏览量
- 0
- 复制安装命令
- 0
- 跳转点击
- 0
社区信号
告诉我们这个 Skill 是否对你的 Agent 工作流有帮助。汇总反馈会持续改善排序。
信任与安全
Do not auto-install
- GitHub 采用度33 个 GitHub Stars检查
- Star/Fork 活跃度33 个 Star，3 个 Fork; 当前元数据中没有议题活跃度信息检查
- 近期维护距上次推送 3 天通过
- 许可证清晰度未知检查
- README/SKILL.md 完整度元数据包含足够的用法与工作流上下文通过
- 依赖与运行时风险command execution surface, network or browser surface信息