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
Perfil del activo
Agents de programación y desarrollo
Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills.
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
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
PrometedorUseful candidate, but compare it with alternatives before adopting.
Confianza
Do not auto-installTrust Score v5 found insufficient evidence for agent installation. Treat this as discovery material, not an executable recommendation.
Auditoría
Requiere revisiónRevisió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.
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.
Tareas adecuadas
- flujos de GitHub automation
- Equipos de Claude Code
- builders willing to evaluate younger projects
- Inspect repository metadata
Agents adecuados
Decisión de instalación
- Comando
- npx skills add shipshitdev/skills --skill comment-mode
- Política
- Revisar
- Revisión humana
- Sí
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-modeNo 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
Skill alternativo
Code Review
168.6K Estrellas
npx skills add mattpocock/skills --skill code-review
Skill alternativo
Grill With Docs
164.7K Estrellas
npx skills add mattpocock/skills --skill grill-with-docs
Skill alternativo
To Spec
164.7K Estrellas
npx skills add mattpocock/skills --skill to-spec
Skill alternativo
To Tickets
176.7K Estrellas
npx skills add mattpocock/skills --skill to-tickets
Seguridad de Agent v2
39/100 · Evitar instalación automática
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
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.
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-modePlan 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 JSON
/api/agent/resolve?task=Use%20comment-mode%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Texto de Resolve
/api/agent/resolve?task=Use%20comment-mode%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Traspaso de instalación
/api/skills/shipshitdev-comment-mode/install
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.
Traspaso de instalación
/api/skills/shipshitdev-comment-mode/install
Formato de texto LLM
/api/skills/shipshitdev-comment-mode/install?format=text
Buscar alternativas
/api/skills/search?q=comment-mode&limit=3
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-modeMetadatos 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.
Manifest
/api/registry/manifest/shipshitdev-comment-mode
Texto LLM
/api/registry/manifest/shipshitdev-comment-mode?format=text
Alias de instalación
/api/registry/install/shipshitdev-comment-mode
Recomendar
/api/registry/recommend?task=Use%20comment-mode%20in%20an%20agent%20workflow&limit=3
Afinidad con Agent
GitHub automation
Etiquetas de uso
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.
Panel de decisión de Agent
Needs validation for GitHub automation
Do a manual repository review before adding this to an agent workflow.
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
- 1Instálalo en un Agent de sandbox y ejecuta una tarea de GitHub automation de principio a fin.
- 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.
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.
Adopción en GitHub
Revisar33 estrellas de GitHub
Actividad de stars/forks
Revisar33 estrellas y 3 forks; la actividad de issues no está disponible en los metadatos actuales
Mantenimiento reciente
Aprobado2 días desde el último push
Claridad de licencia
RevisarDesconocido
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.
Ajuste de flujo
Usa esta skill en estos escenarios
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.
Ajuste de flujo
Añadir a un flujo completo
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.
Lista de alternativas
Compara antes de instalar
Similar skills that may fit this task.
Code Review
Review a branch or diff against repository standards and the originating spec in two independent analysis passes.
Grill With Docs
A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.
To Spec
Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.
To Tickets
Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.
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
recent repository activity
Auditoría
Revisión de instalación
Revisión de instalación y adopción
- Seguridad
- 67/100
- Mantenimiento
- 100/100
- Instalar
- 92/100
Evidencia probada por Agent
Evidencia probada por Agent
Informes de resultados tras resolver, revisar, instalar y una ejecución limitada.
- 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
Borrador basado en un caso para comment-mode, listo para publicar manualmente en 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
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
Esta ficha se indexó desde fuentes públicas y no está marcada como oficial hasta que se apruebe una reclamación de mantenedor.
- Creador
- shipshitdev
- Fuente
- shipshitdev/skills
- 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 skillReclamació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.
[](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)Autor
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
- 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
Skills relacionados
Code Review
Review a branch or diff against repository standards and the originating spec in two independent analysis passes.
168.6K EstrellasGrill With Docs
A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.
164.7K EstrellasTo Spec
Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.
164.7K EstrellasTo Tickets
Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.
176.7K Estrellas