julia-docstrings

Generate Julia docstrings using DocStringExtensions.jl macros and SciML conventions.

30|6|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/Krastanov/JuliaLLMAgentSkills --skill julia-docstrings
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: julia-docstrings
Source: https://github.com/Krastanov/JuliaLLMAgentSkills/tree/main/julia-docstrings
Command: npx skills add https://github.com/Krastanov/JuliaLLMAgentSkills --skill julia-docstrings

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you write clear, consistent, and informative documentation for your Julia code, making it easier for others (and your future self) to understand and use.

Core Features & Use Cases

  • Standardized Documentation: Follows SciML conventions for documenting functions, types, and modules.
  • DocStringExtensions.jl Integration: Leverages macros like $TYPEDEF, $TYPEDFIELDS, and $TYPEDSIGNATURES for concise and structured docstrings.
  • Use Case: When you've just finished writing a new Julia function, use this skill to generate a well-formatted docstring that explains its purpose, arguments, return values, and includes examples.

Quick Start

Use the julia-docstrings skill to write a docstring for the following function signature: function my_function(x::Int, y::String)

Frequently Asked Questions about julia-docstrings

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate Julia docstrings for exported functions?

To generate Julia docstrings for exported functions, you provide the function signature to the skill, which then produces standardized documentation using DocStringExtensions.jl macros like $TYPEDSIGNATURES for clear argument and return value formatting.

What is the best way to document Julia public types using SciML conventions?

Documenting Julia public types using SciML conventions involves applying specific DocStringExtensions.jl macros like $TYPEDEF and $TYPEDFIELDS to ensure structured, discoverable type definitions and field descriptions within your package.

How does DocStringExtensions.jl work with Julia package modules?

DocStringExtensions.jl works with Julia package modules by providing macros that automatically extract type definitions and typed fields, ensuring standardized, user-facing documentation for key modules without manual duplication of code signatures.

Can I use this to document a Julia package without manually writing function signatures?

Yes, you can document Julia packages without manually writing signatures because the skill leverages DocStringExtensions.jl macros like $TYPEDSIGNATURES to automatically populate function signatures, reducing manual transcription errors in your docstrings.

What are the limitations of using DocStringExtensions macros for Julia code?

A limitation of using DocStringExtensions macros for Julia code is that adherence to SciML conventions is required, meaning the generated docstrings must apply specific macro usage for types, fields, and signatures to ensure proper discoverability.

When do I need to apply specific macros for Julia type definitions and fields?

You need to apply specific macros like $TYPEDEF and $TYPEDFIELDS for Julia type definitions and fields when documenting public types to ensure the generated docstrings adhere to SciML conventions and maintain proper discoverability.