Module skills 

Skills System for Rusty Commit

Skills are modular extensions that allow users to customize and extend rusty-commit’s functionality. They can be used to:

• Define custom commit message templates
• Add custom analysis modules
• Create custom output formatters
• Hook into the commit generation pipeline

Skill Structure

Skills are stored in ~/.config/rustycommit/skills/ and are either:

• Built-in: Included with rusty-commit
• Local: User-created skills in the skills directory
• Project: Team-shared skills in .rco/skills/
• External: Imported from Claude Code, GitHub, etc.

Skill Manifest

Each skill has a skill.toml manifest:

[skill]
name = "conventional-with-scope"
version = "1.0.0"
description = "Conventional commits with automatic scope detection"
author = "Your Name"

[skill.hooks]
pre_gen = "pre_gen.sh"      # Optional: runs before AI generation
post_gen = "post_gen.sh"    # Optional: runs after AI generation
format = "format.sh"        # Optional: formats the output

External Skills

rusty-commit can import skills from:

• Claude Code: ~/.claude/skills/ - Claude Code custom skills
• GitHub: Repositories with .rco/skills/ directory
• GitHub Gist: Single-file skill definitions
• URL: Direct download from any HTTP(S) URL

Modules

builtin

Built-in skills that are always available

external

External skill importers

Structs

Skill

A loaded skill with its manifest and path

SkillConfigOption

Configuration option schema

SkillHooks

Skill hooks for pipeline integration

SkillManifest

A skill manifest defining the skill’s metadata and capabilities

SkillMeta

Skill metadata

SkillsManager

Skills manager - handles discovery and loading of skills

Enums

SkillCategory

Skill categories

SkillSource

Skill source/origin

Constants

SKILLS_DIR

Skills directory name

SKILL_MANIFEST

Skill manifest filename