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
Profil de l’actif
Agents de code et de développement
Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills.
Scénario
GitHub automation
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Adéquation Agent
Claude Code + Cursor + Browser agents
Compatible avec Codex, Claude Code, Cursor, CLI ou des Agents personnalisés.
Installer
Prêt
npx skills add shipshitdev/skills --skill comment-mode
Maintenance
À jour
3 jours depuis le dernier push
Risque
Revue nécessaire
La licence est ambiguë
Qualité GitHub
33
57/100 Qualité · 66/100 Confiance
Tags de couverture
Notes de revue
La licence est ambiguë · Permission surface may require sandboxing
Carte d’adoption Agent
Confiance, audit et préparation à l’installation en un coup d’œil
Ces scores combinent les métadonnées publiques du dépôt, les signaux de revue OpenAgentSkill, la fraîcheur de maintenance et la préparation à l’installation. Ils servent à présélectionner et ne remplacent pas la revue humaine.
Qualité
PrometteurUseful candidate, but compare it with alternatives before adopting.
Confiance
Do not auto-installTrust Score v5 found insufficient evidence for agent installation. Treat this as discovery material, not an executable recommendation.
Audit
Revue nécessaireRevue lisible par machine de la préparation à l’installation, des métadonnées de sécurité, de la maintenance et du risque d’adoption.
Trust Score OpenAgentSkill v5
Revue humaine avant installation
Choose a stronger alternative or inspect the source manually before any install attempt.
Stars
33 stars GitHub
Activité du dépôt
33 stars et 3 forks
Maintenance
3 jours depuis le dernier push
Licence
Inconnu
Installer
npx skills add shipshitdev/skills --skill comment-mode
Sécurité d’installation
Chemin d’installation standard de package ou runtime
Surface de permissions
shell or command execution, filesystem or document access
Résultats Agent
Pas encore de données de résultats Agent
Documentation
Contexte README/SKILL.md solide
Résumé des risques
Revoir avant production
- 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 licence est ambiguë
- Low GitHub adoption signal
Préparation à l’installation
Chemin d’installation disponible
- Le chemin d’installation est disponible
- La preuve du dépôt est disponible
- La licence est ambiguë
- Pas encore de preuve de résultat Agent-Proven
Métadonnées lisibles par Agent
Données de décision lisibles par machine pour ce skill.
Utilisez ce bloc ou le JSON intégré pour décider si un Agent doit installer ce skill, choisir une alternative ou demander d’abord une revue humaine.
Tâches adaptées
- workflows GitHub automation
- Équipes Claude Code
- builders willing to evaluate younger projects
- Inspect repository metadata
Agents adaptés
Décision d’installation
- Commande
- npx skills add shipshitdev/skills --skill comment-mode
- Politique
- Revoir
- Revue humaine
- Oui
Confiance et risque
- Confiance
- 58/100
- Audit
- 71/100
- Niveau de risque
- Revue nécessaire
Boucle de résultat
- Endpoint
- /api/agent/outcome
- ID d’événement
- resolve
- Résultats
- 5
Commande d’installation
npx skills add shipshitdev/skills --skill comment-modeNe pas utiliser quand
- Équipes qui nécessitent un SLA soutenu par le fournisseur
- 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 alternatif
Opencode
200.7K Stars
npx skills add anomalyco/opencode
Skill alternatif
Code Review
168.6K Stars
npx skills add mattpocock/skills --skill code-review
Skill alternatif
Grill With Docs
164.7K Stars
npx skills add mattpocock/skills --skill grill-with-docs
Skill alternatif
To Spec
164.7K Stars
npx skills add mattpocock/skills --skill to-spec
Sécurité Agent v2
39/100 · Éviter l’installation automatique
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
Élevé
Exécution shell ou de commande
Les métadonnées de la skill font référence à des workflows de terminal, CLI, shell, sous-processus ou exécution de commande.
Moyen
Browser automation
Skill may drive a browser or interact with web pages.
Moyen
Accès réseau
La skill récupère probablement des pages distantes, API, dépôts ou services externes.
Moyen
Accès au système de fichiers
La skill peut lire ou écrire des fichiers de projet, documents, artefacts générés ou l’état local de l’espace de travail.
- Indices de permissions à haut risque : exécution shell ou de commande
- La licence est ambiguë
Cibles d’installation
Installer ce skill dans votre workflow Agent
Utilisez le point de terminaison public pour récupérer la commande, la checklist, les prompts et les liens canoniques.
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 résolution Agent
Laissez un Agent vérifier la pertinence avant l’installation.
L’API Resolve renvoie la skill sélectionnée, des alternatives, la politique de sécurité, les notes d’audit, la cible d’installation et un prompt prêt à l’emploi.
Ouvrir JSON
/api/agent/resolve?task=Use%20comment-mode%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Texte Resolve
/api/agent/resolve?task=Use%20comment-mode%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Relais d’installation
/api/skills/shipshitdev-comment-mode/install
L’Agent doit vérifier
- 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.
Copier le 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.Relais Agent
Donnez à l’Agent le chemin d’installation, pas un autre annuaire.
Utilisez le point de terminaison public pour récupérer la commande, la checklist, les prompts et les liens canoniques.
Relais d’installation
/api/skills/shipshitdev-comment-mode/install
Format texte LLM
/api/skills/shipshitdev-comment-mode/install?format=text
Trouver des alternatives
/api/skills/search?q=comment-mode&limit=3
Prompt 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-modeMétadonnées Registry
Profil lisible par Agent pour la sélection automatique de skills.
L’API Registry fournit les signaux de décision, confiance, audit, cas d’usage et installation sans analyser l’interface.
Manifest
/api/registry/manifest/shipshitdev-comment-mode
Texte LLM
/api/registry/manifest/shipshitdev-comment-mode?format=text
Alias d’installation
/api/registry/install/shipshitdev-comment-mode
Recommander
/api/registry/recommend?task=Use%20comment-mode%20in%20an%20agent%20workflow&limit=3
Adéquation Agent
GitHub automation
Tags de cas d’usage
Plateformes
Claude Code, Cursor, Browser agents
Rapport d’audit
Revue nécessaire · 71/100
Revue lisible par machine de la préparation à l’installation, des métadonnées de sécurité, de la maintenance et du risque d’adoption.
Panneau de décision Agent
Needs validation for GitHub automation
Do a manual repository review before adding this to an agent workflow.
Rôle dans la pile
Validation nécessaire
Pertinence principale
GitHub automation
Libellé de confiance
Revue manuelle nécessaire
Chemin d’installation
Commande prête
À utiliser lorsque
- workflows GitHub automation
- Équipes Claude Code
- builders willing to evaluate younger projects
Preuves
- recent repository activity
- install command or GitHub repo available
- profil qualité 57/100
revoir d’abord
- 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
Chemin d’implémentation
- 1Installez-le dans un Agent en sandbox et exécutez une tâche de GitHub automation de bout en bout.
- 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.
Profil de confiance
Do not auto-install
Trust Score v5 found insufficient evidence for agent installation. Treat this as discovery material, not an executable recommendation.
Adoption GitHub
Vérifier33 stars GitHub
Activité stars/forks
Vérifier33 stars et 3 forks; l’activité des issues n’est pas disponible dans les métadonnées actuelles
Maintenance récente
Validé3 jours depuis le dernier push
Clarté de licence
VérifierInconnu
Signaux positifs
- Revue IA approuvée
- Le chemin d’installation est disponible
- La preuve du dépôt est disponible
- Dépôt maintenu récemment
- La commande d’installation ne présente aucun motif de haut risque évident
- La boucle de résultats est prête mais nécessite la première exécution réelle de l’Agent
Réviser avant installation
- 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 licence est ambiguë
- 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
- Pas encore de rapports de résultats Agent réels
- Une revue humaine est requise avant une installation sans surveillance
Action recommandée
Choose a stronger alternative or inspect the source manually before any install attempt.
Profil qualité
Prometteur candidat pour les workflows Agent
Useful candidate, but compare it with alternatives before adopting.
Adéquation au workflow
Utilisez cette skill dans ces scénarios
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.
Adéquation au workflow
Ajouter à un workflow complet
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.
Liste d’alternatives
Comparer avant installation
Similar skills that may fit this task.
Opencode
The open source coding agent.
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.
Vue d’ensemble
--- 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 ```
Détails techniques
- Version
- 1.0.0
- Licence
- Unknown
- Dernière mise à jour
- 23 août 2026
- Publié
- 23 août 2026
Instantané de décision
Validation nécessaire
recent repository activity
Audit
Revue d’installation
Revue d’installation et d’adoption
- Sécurité
- 67/100
- Maintenance
- 100/100
- Installer
- 92/100
Preuves validées par Agent
Preuves validées par Agent
Rapports après resolve, revue, installation et une exécution limitée.
- Taux de réussite
- —
- Échec récent
- —
- Résultats
- 0
- Qualité de sortie
- —
- Échecs
- 0
- Non pertinent
- 0
- Installations
- 0
- Bloqué par le risque
- 0
- Configuration requise
- 0
- Production
- 0
Aucune donnée de résultat Agent pour l’instant. La première exécution peut signaler succès, besoin de configuration, blocage de risque, échec ou non-pertinence via /api/agent/outcome.
Installer
Ajouter au workflow Agent
Gratuit et open source. Examinez le rapport avant l’installation dans des Agents de production.
Boucle de croissance
Kit de partage
Brouillon guidé par scénario pour comment-mode, prêt pour une publication manuelle sur 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
Réponse facultative avec commande d’installation
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
Source de la fiche
Indexé par Registry
Cette fiche a été indexée à partir de sources publiques et n’est pas marquée officielle tant qu’une revendication de mainteneur n’est pas approuvée.
- Créateur
- shipshitdev
- Source
- shipshitdev/skills
- Indexé par
- Index communautaire OpenAgentSkill
L’attribution renvoie au dépôt public ou au profil du créateur. Les créateurs peuvent revendiquer la fiche pour mettre à jour les signaux de propriété.
Revendiquer ce skillRevendication du propriétaire
Revendiquer cette fiche de skill
Cette fiche Indexé par Registry est attribuée à shipshitdev, mais n’est pas encore marquée officielle. Revendiquez-la pour ajouter un signal de propriétaire vérifié et rendre les futures mises à jour de lancement, d’installation et d’audit plus fiables.
Kit de backlinks créateur
Ajoutez les badges de preuve à votre README
Affichez la fiche canonique, les signaux actuels de confiance et d’audit, ainsi que de vraies preuves Agent-Proven là où les développeurs évaluent le dépôt.
[](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)Auteur
shipshitdev
@shipshitdev
Tags
Adéquation plateforme
Signaux de santé
- Stars GitHub
- 33
- Score de qualité
- 34/100
- Dernier push GitHub
- 20 août 2026
- Indications de framework
- Inconnu
- Vues OpenAgentSkill
- 0
- Copies d’installation
- 0
- Clics sortants
- 0
Signal de communauté
Indiquez si ce skill semble utile à votre workflow Agent. Les retours agrégés améliorent le classement au fil du temps.
Confiance et sécurité
Do not auto-install
- Adoption GitHub33 stars GitHubVérifier
- Activité stars/forks33 stars et 3 forks; l’activité des issues n’est pas disponible dans les métadonnées actuellesVérifier
- Maintenance récente3 jours depuis le dernier pushValidé
- Clarté de licenceInconnuVérifier
- Complétude README/SKILL.mdLes métadonnées incluent suffisamment de contexte d’usage et de workflowValidé
- Risque dépendances/runtimecommand execution surface, network or browser surfaceInfo
Skills associés
Opencode
The open source coding agent.
200.7K StarsCode Review
Review a branch or diff against repository standards and the originating spec in two independent analysis passes.
168.6K StarsGrill 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 StarsTo Spec
Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.
164.7K Stars