self-add-skill

What problem does it solve?

This Skill provides a clear, repository-centric method to add new AI skills to a Nix home-manager managed environment without risking overwriting existing user configurations. It consolidates placement, frontmatter formatting, and deployment into a repeatable workflow.

Core Features & Use Cases

• Centralizes skill creation under modules/home/ai/skills/<skill-name>, enabling versioning and peer review.
• Guides users to create a properly formatted SKILL.md with required frontmatter, and to commit changes via git.
• Applies changes on the target host using home-manager switch, ensuring consistent deployment across machines.
• Use Case: When you want to introduce a new skill named code-review, add the directory and SKILL.md, commit, and run home-manager switch to apply it.

Quick Start

• Create the skill directory within the repository: mkdir -p ~/src/github.com/ojii3/dotfiles/modules/home/ai/skills/<skill-name>

• Write a SKILL.md in that directory following the frontmatter format:

  name: <skill-name> description: <skill description>

  <skill content>
• Add and commit the change to git: cd ~/src/github.com/ojii3/dotfiles; git add modules/home/ai/skills/<skill-name>; git commit -m "Add new skill <skill-name>"
• Apply the change on the host: home-manager switch --flake .#ojii3@$(hostname)