comment-mode

Revisar · 58
Indexado en Registry

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

Verified installs0
Estrellas33
Versión1.0.0
Calidad57/100 · Prometedor
Confianza58/100 · Do not auto-install
Auditoría71/100 · Requiere revisión

Perfil del activo

Agents de programación y desarrollo

Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills.

Ver categoría

Escenario

GitHub automation

I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.

Afinidad con Agent

Claude Code + Cursor + Browser agents

Funciona con Codex, Claude Code, Cursor, CLI o Agents personalizados.

Instalar

Listo

npx skills add shipshitdev/skills --skill comment-mode

Mantenimiento

Actual

2 días desde el último push

Riesgo

Requiere revisión

La licencia no está clara

Calidad de GitHub

33

57/100 Calidad · 66/100 Confianza

Etiquetas de cobertura

CodingGitHub automationAgents de programaciónagent-skill

Notas de revisión

La licencia no está clara · Permission surface may require sandboxing

Tarjeta de adopción del Agent

Confianza, auditoría y preparación de instalación de un vistazo

Estas puntuaciones combinan metadatos públicos del repositorio, señales de revisión de OpenAgentSkill, actualidad de mantenimiento y preparación de instalación. Sirven para preseleccionar; no sustituyen la revisión humana.

Calidad

Prometedor
57

Useful candidate, but compare it with alternatives before adopting.

Confianza

Do not auto-install
58

Trust Score v5 found insufficient evidence for agent installation. Treat this as discovery material, not an executable recommendation.

Auditoría

Requiere revisión
71

Revisión legible por máquina de la preparación de instalación, los metadatos de seguridad, el mantenimiento y el riesgo de adopción.

Trust Score de OpenAgentSkill v5

Revisión humana antes de instalar

Choose a stronger alternative or inspect the source manually before any install attempt.

CodexClaude CodeCursorOpenAgentSkill CLI

Estrellas

33 estrellas de GitHub

Actividad del repositorio

33 estrellas y 3 forks

Mantenimiento

2 días desde el último push

Licencia

Desconocido

Instalar

npx skills add shipshitdev/skills --skill comment-mode

Seguridad de instalación

Ruta estándar de paquete o instalación en tiempo de ejecución

Superficie de permisos

shell or command execution, filesystem or document access

Resultados del Agent

Aún no hay datos de resultados del Agent

Documentación

Contexto sólido de README/SKILL.md

Resumen de riesgo

Revisar antes de producción

  • 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.
  • La licencia no está clara
  • Low GitHub adoption signal

Preparación de instalación

Ruta de instalación disponible

  • La ruta de instalación está disponible
  • La evidencia del repositorio está disponible
  • La licencia no está clara
  • Aún no hay evidencia de resultados Agent-Proven

Metadatos legibles por Agent

Datos de decisión legibles por máquina para este skill.

Usa este bloque o el JSON integrado para decidir si un Agent debe instalar este skill, elegir una alternativa o pedir revisión humana primero.

Abrir JSON

Tareas adecuadas

  • flujos de GitHub automation
  • Equipos de Claude Code
  • builders willing to evaluate younger projects
  • Inspect repository metadata

Agents adecuados

CodexClaude CodeCursorOpenAgentSkill CLIBrowser agentsCLI

Decisión de instalación

Comando
npx skills add shipshitdev/skills --skill comment-mode
Política
Revisar
Revisión humana

Confianza y riesgo

Confianza
58/100
Auditoría
71/100
Nivel de riesgo
Requiere revisión

Ciclo de resultados

Endpoint
/api/agent/outcome
ID del evento
resolve
Resultados
5

Comando de instalación

npx skills add shipshitdev/skills --skill comment-mode

No usar cuando

  • Equipos que necesitan un SLA con soporte del proveedor
  • 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.
  • No OpenAgentSkill engagement data yet

Seguridad de Agent v2

39/100 · Evitar instalación automática

ExperimentalRevisar

Sparse or mixed signals. Useful for discovery, but not for autonomous installation.

Test manually in an isolated workspace and compare against safer alternatives.

Resolver con API

Alto

Ejecución de shell o comandos

Los metadatos del skill hacen referencia a terminal, CLI, shell, subprocesos o flujos de ejecución de comandos.

Medio

Browser automation

Skill may drive a browser or interact with web pages.

Medio

Acceso a red

El skill probablemente consulta páginas remotas, API, repositorios o servicios externos.

Medio

Acceso al sistema de archivos

El skill puede leer o escribir archivos de proyecto, documentos, artefactos generados o estado local.

  • Indicios de permisos de alto riesgo: ejecución de shell o comandos
  • La licencia no está clara

Destinos de instalación

Instala este skill en tu flujo de Agent

Usa el endpoint público para obtener el comando, la lista de seguridad, prompts y enlaces canónicos.

skill install

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-mode

Plan de resolución de Agent

Deja que un Agent valide el ajuste antes de instalar.

La API Resolve devuelve la skill elegida, alternativas, política de seguridad, notas de auditoría, destino de instalación y un prompt listo para usar.

Abrir plan de texto

Agent debe revisar

  • Task fit and alternatives from Resolve API.
  • Audit score, trust score, and safety policy warnings.
  • Install target compatibility for Codex, Claude Code, Cursor, or CLI.

Copiar prompt

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.

Traspaso de Agent

Da al Agent la ruta de instalación, no otro directorio.

Usa el endpoint público para obtener el comando, la lista de seguridad, prompts y enlaces canónicos.

Abrir API de instalación

Prompt de 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-mode

Metadatos del Registry

Perfil legible por Agent para seleccionar skills automáticamente.

La API Registry expone señales de decisión, confianza, auditoría, casos de uso e instalación sin raspar la interfaz.

Abrir Manifest

Afinidad con Agent

56/100

GitHub automation

Plataformas

Claude Code, Cursor, Browser agents

Informe de auditoría

Requiere revisión · 71/100

Revisión legible por máquina de la preparación de instalación, los metadatos de seguridad, el mantenimiento y el riesgo de adopción.

Ver informe de auditoríaVer informe de evaluación

Panel de decisión de Agent

Needs validation for GitHub automation

Do a manual repository review before adding this to an agent workflow.

56
Preparación
Revisar
Etapa

Rol en la pila

Requiere validación

Ajuste principal

GitHub automation

Etiqueta de confianza

Requiere revisión manual

Ruta de instalación

Comando listo

Úsalo cuando

  • flujos de GitHub automation
  • Equipos de Claude Code
  • builders willing to evaluate younger projects

Evidencia

  • recent repository activity
  • install command or GitHub repo available
  • perfil de calidad 57/100

revisar primero

  • Low GitHub adoption signal
  • Repository license detected as Unknown, though plugin.json declares MIT. This mismatch may cause compliance ambiguity.
  • No OpenAgentSkill engagement data yet

Ruta de implementación

  1. 1Instálalo en un Agent de sandbox y ejecuta una tarea de GitHub automation de principio a fin.
  2. 2Compare output quality, latency, and failure behavior against at least one alternative.
  3. 3Promote it into production only after reviewing repository permissions, license, and maintenance signals.

Perfil de confianza

Do not auto-install

Trust Score v5 found insufficient evidence for agent installation. Treat this as discovery material, not an executable recommendation.

58
Trust Score de OpenAgentSkill

Adopción en GitHub

Revisar

33 estrellas de GitHub

Actividad de stars/forks

Revisar

33 estrellas y 3 forks; la actividad de issues no está disponible en los metadatos actuales

Mantenimiento reciente

Aprobado

2 días desde el último push

Claridad de licencia

Revisar

Desconocido

Señales positivas

  • Revisión de IA aprobada
  • La ruta de instalación está disponible
  • La evidencia del repositorio está disponible
  • Repositorio mantenido recientemente
  • El comando de instalación no muestra un patrón de alto riesgo evidente
  • El ciclo de resultados está listo, pero necesita la primera ejecución real de Agent

Revisar antes de instalar

  • 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.
  • La licencia no está clara
  • 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
  • Aún no hay informes reales de resultados del Agent
  • Se requiere revisión humana antes de una instalación desatendida

Acción recomendada

Choose a stronger alternative or inspect the source manually before any install attempt.

Perfil de calidad

Prometedor candidato para flujos de Agent

Useful candidate, but compare it with alternatives before adopting.

57
Estrellas de GitHub
33
Actualidad
hace 2 días
Listo para instalar
Licencia
Desconocido
Revisar antes de instalar: Low GitHub adoption signal · Repository license detected as Unknown, though plugin.json declares MIT. This mismatch may cause compliance ambiguity.

Ajuste de flujo

Usa esta skill en estos escenarios

Ajuste de flujo

Añadir a un flujo completo

Lista de alternativas

Compara antes de instalar

Similar skills that may fit this task.

Comparar todo

Resumen

--- 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 ```

Detalles técnicos

Versión
1.0.0
Licencia
Unknown
Última actualización
23 ago 2026
Publicado
23 ago 2026

Resumen de decisión

Requiere validación

56
Listo
Revisar
Etapa

recent repository activity

Auditoría

Revisión de instalación

Revisión de instalación y adopción

71
Requiere revisión
Seguridad
67/100
Mantenimiento
100/100
Instalar
92/100
Abrir auditoría completaVer informe de evaluación

Evidencia probada por Agent

Evidencia probada por Agent

Informes de resultados tras resolver, revisar, instalar y una ejecución limitada.

0
Probado
Needs first agent runAuto-instalación: revisar primeroÚltimo: Desconocido
Tasa de éxito
Fallo reciente
Resultados
0
Calidad de salida
Fallidos
0
No relevante
0
Instalaciones
0
Bloqueado por riesgo
0
Configuración necesaria
0
Producción
0

Aún no hay datos de resultados de Agent. La primera ejecución puede informar éxito, configuración necesaria, bloqueos de riesgo, fallo o irrelevancia mediante /api/agent/outcome.

Instalar

Añadir al flujo de Agent

Gratis y de código abierto. Revisa el informe antes de instalar en Agents de producción.

Bucle de crecimiento

Kit para compartir

X

Borrador basado en un caso para comment-mode, listo para publicar manualmente en X.

Nota del curador
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
Abrir borrador de X
Respuesta opcional con comando de instalación
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

Fuente de la ficha

Indexado por Registry

Reclamable

Esta ficha se indexó desde fuentes públicas y no está marcada como oficial hasta que se apruebe una reclamación de mantenedor.

Indexado por
Índice comunitario de OpenAgentSkill

La atribución enlaza al repositorio público o al perfil del creador. Los creadores pueden reclamar la ficha para actualizar las señales de propiedad.

Reclamar este skill

Reclamación del propietario

Reclamar esta ficha de skill

Esta ficha Indexado por Registry se atribuye a shipshitdev, pero aún no está marcada como oficial. Reclámala para añadir una señal de propietario verificado y hacer más fiables futuras actualizaciones de lanzamiento, instalación y auditoría.

Kit de enlaces para creadores

Añade las insignias de evidencia a tu README

Muestra la ficha canónica, las señales actuales de confianza y auditoría, y evidencia real de Agent-Proven donde los desarrolladores evalúan el repositorio.

[![Listed on OpenAgentSkill](https://www.openagentskill.com/api/badge/shipshitdev-comment-mode?metric=listed&label=Listed)](https://www.openagentskill.com/skills/shipshitdev-comment-mode)
[![OpenAgentSkill Trust](https://www.openagentskill.com/api/badge/shipshitdev-comment-mode?metric=trust&label=Trust)](https://www.openagentskill.com/skills/shipshitdev-comment-mode)
[![OpenAgentSkill Audit](https://www.openagentskill.com/api/badge/shipshitdev-comment-mode?metric=audit&label=Audit)](https://www.openagentskill.com/skills/shipshitdev-comment-mode/audit)
[![Agent Proven](https://www.openagentskill.com/api/badge/shipshitdev-comment-mode?metric=proven&label=Agent%20Proven)](https://www.openagentskill.com/skills/shipshitdev-comment-mode)

Autor

S

shipshitdev

@shipshitdev

Etiquetas

Afinidad con plataforma

Señales de salud

Estrellas de GitHub
33
Puntuación de calidad
34/100
Último push de GitHub
20 ago 2026
Pistas del framework
Desconocido
Vistas de OpenAgentSkill
0
Copias de instalación
0
Clics externos
0

Señal de comunidad

Comparte si este skill resulta útil para tu flujo de Agent. Los comentarios agregados mejoran la clasificación con el tiempo.

Confianza y seguridad

Do not auto-install

58
  • Adopción en GitHub33 estrellas de GitHubRevisar
  • Actividad de stars/forks33 estrellas y 3 forks; la actividad de issues no está disponible en los metadatos actualesRevisar
  • Mantenimiento reciente2 días desde el último pushAprobado
  • Claridad de licenciaDesconocidoRevisar
  • Completitud de README/SKILL.mdLos metadatos incluyen suficiente contexto de uso y flujo de trabajoAprobado
  • Riesgo de dependencias/runtimecommand execution surface, network or browser surfaceInfo