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.

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

011 GitHub stars

02Automatic transformation of implementation notes into professional documentation blocks

03Standardized workflow for deferring complex tasks during the planning phase

04Systematic handling of @implement, @docs, @refactor, @test, and @todo directives

05External documentation fetching and integration via @docs URL directives

06Context-aware post-action cleanup to prevent comment rot and technical debt

Casos de Uso

01Integrating external API documentation into the coding context using URL-based reference directives

02Transforming rough inline implementation notes into production-grade JSDoc or Python docstrings

03Managing development scope by marking 'skip for now' tasks with actionable markers for later processing

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add asermax/claude-plugins using-code-directives

For use in Claude.ai and ChatGPT

Características Principales

011 GitHub stars

02Automatic transformation of implementation notes into professional documentation blocks

03Standardized workflow for deferring complex tasks during the planning phase

04Systematic handling of @implement, @docs, @refactor, @test, and @todo directives

05External documentation fetching and integration via @docs URL directives

06Context-aware post-action cleanup to prevent comment rot and technical debt

Casos de Uso

01Integrating external API documentation into the coding context using URL-based reference directives

02Transforming rough inline implementation notes into production-grade JSDoc or Python docstrings

03Managing development scope by marking 'skip for now' tasks with actionable markers for later processing