Communitygithub.com

chonamdoo/comment-authoring-discipline

Aplica criterios de calidad de comentarios durante la implementación y en la pasada final de calidad de comentarios antes de la revisión final, revisión múltiple o revisión de arquitectura tras cambios de código. Aplica por igual en Codex, Claude y OMP para Python, Kotlin, React Web, React Native, iOS, Swift y SwiftUI.

¿Qué es comment-authoring-discipline?

Esta habilidad del agente AI garantiza que los comentarios en el código base sean de alta calidad y consistentes, aplicando criterios específicos tanto durante la implementación como en una pasada final antes de revisiones importantes. Es útil porque los comentarios de baja calidad pueden generar confusión, errores y costos de mantenimiento adicionales. La habilidad es compatible con plataformas como Codex, Claude y OMP, y funciona con lenguajes como Python, Kotlin, React Web, React Native, iOS, Swift y SwiftUI. Funciona instruyendo al agente AI para evaluar los comentarios según criterios como claridad, precisión, relevancia y estado de actualización, eliminando comentarios redundantes o engañosos, y asegurando que la intención del código se comunique efectivamente.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/chonamdoo/agent-flow/tree/main/skills/comment-authoring-discipline

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace comment-authoring-discipline?

Aplica criterios de calidad de comentarios durante la implementación y en la pasada final de calidad de comentarios antes de la revisión final, revisión múltiple o revisión de arquitectura tras cambios de código. Aplica por igual en Codex, Claude y OMP para Python, Kotlin, React Web, React Native, iOS, Swift y SwiftUI.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

chonamdoo/code-generation-discipline

Common code generation and code modification discipline for agent-flow. Use before and during implementation, TDD red/green/refactor, fix-loop, bug fixes, feature work, and any task where Codex, Claude, OMP, or another agent writes or changes code. Enforces start-before, during-implementation, and after-implementation checks without a scoring rubric.

chonamdoo/flutter-development-guide

Flutter implementation and review checklist. Use only when writing, modifying, or reviewing Flutter widget code, layout constraints, adaptive sizing, navigation and routing, platform channels, platform views, background entry points, list and image performance, async gaps across `BuildContext`, disposal, theme and design tokens, accessibility, localization, offline and error states, or Flutter test and golden coverage. Do not use for Dart language generalities, native Android or iOS internals beyond the engine and channel-registration seam a Dart entry point depends on, or broad rewrites.

chonamdoo/ios-app-shell-error-handling

Use when implementing or reviewing iOS app-wide error handling where SwiftUI views/ViewModels notify common errors and an @main App, WindowGroup AppShell, NavigationStack coordinator, or UIKit AppCoordinator owns root navigation, tab/session flow switching, alerts, sheets, toast hosts, SessionExpired handling, Maintenance handling, and root reset behavior.

chonamdoo/ios-clean-presentation-architecture

Use when creating, modifying, or reviewing an iOS Clean Architecture presentation layer with SwiftUI/UIKit state holders, explicit UiState, UiModel mapping, dependency injection, and state-based presentation code review.

chonamdoo/to-prd

Synthesizes the current conversation and codebase context into a PRD, then writes or publishes it according to the caller's requested output target. Use when the user asks to turn an already-discussed idea, plan, or conversation into a PRD; use `grilling` first if key decisions are still unresolved.

Skills relacionados