Can I point Claude to external documentation using this skill?

Absolutely. Use the @docs directive to provide Claude with external context or API references that it should consider while editing or writing code.

Does this skill remove my comments automatically?

Yes, depending on the directive type. One-time actions like @refactor or @test are removed after completion, while @implement is often transformed into proper documentation like JSDoc.

What are code directives?

Code directives are specialized comments (like @implement or @refactor) that act as triggers for Claude, providing specific instructions on how to handle code implementation, documentation, or testing.

Why should I use directives instead of just asking Claude in chat?

Directives keep instructions contextual and inline with the code they refer to. This prevents 'context drift' and ensures that requirements are always visible to the AI when it's working on a specific file.

What happens if I forget a directive in my code?

Claude is trained to recognize these patterns. When it encounters one, it will follow the established workflow to execute the instruction and then clean up the comment based on post-action rules.

Contextual Code Directives

Name: Contextual Code Directives
Author: asermax

byasermax

•

Productividad y Flujo de Trabajo

Enables Claude to systematically process, execute, and transform inline code instructions like @implement, @refactor, and @todo.

Acerca de

Contextual Code Directives provide a structured framework for Claude to recognize and act upon specialized comments embedded directly within your source code. By using tags such as @implement, @docs, and @test, developers can keep implementation instructions, external references, and refactoring tasks contextual and inline rather than scattered across external project management tools. This skill ensures that Claude follows specific procedures for each directive type, automatically transforming them into proper documentation (like JSDoc or docstrings) or removing them once completed to maintain a clean, production-ready codebase.

Características Principales

1 GitHub stars
Automatic transformation of implementation notes into professional documentation blocks
Standardized workflow for deferring complex tasks during the planning phase
Systematic handling of @implement, @docs, @refactor, @test, and @todo directives
External documentation fetching and integration via @docs URL directives
Context-aware post-action cleanup to prevent comment rot and technical debt

Casos de Uso

Integrating external API documentation into the coding context using URL-based reference directives
Transforming rough inline implementation notes into production-grade JSDoc or Python docstrings
Managing development scope by marking 'skip for now' tasks with actionable markers for later processing

Acerca de

Características Principales

1 GitHub stars
Automatic transformation of implementation notes into professional documentation blocks
Standardized workflow for deferring complex tasks during the planning phase
Systematic handling of @implement, @docs, @refactor, @test, and @todo directives
External documentation fetching and integration via @docs URL directives
Context-aware post-action cleanup to prevent comment rot and technical debt

Casos de Uso

Integrating external API documentation into the coding context using URL-based reference directives
Transforming rough inline implementation notes into production-grade JSDoc or Python docstrings
Managing development scope by marking 'skip for now' tasks with actionable markers for later processing