self-add-skill

Name: self-add-skill
Availability: InStock
Author: OJII3

Add a new AI skill under modules/home/ai/skills with SKILL.md frontmatter and deploy via home-manager switch.

16|1|Updated Apr 25, 2023

Search Tags:#automation #git #deployment #dotfiles #skill-management #home-manager #Nix

Ready to run

npx skills add https://github.com/OJII3/dotfiles --skill self-add-skill

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: self-add-skill
Source: https://github.com/OJII3/dotfiles/tree/main/modules/home/ai/skills/self-add-skill
Command: npx skills add https://github.com/OJII3/dotfiles --skill self-add-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

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)

Frequently Asked Questions about self-add-skill

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

FAQPage Schema

How do I add a new AI skill to a Nix home-manager setup without overwriting existing configurations?▼

To add a new AI skill in a Nix home-manager environment, you create a dedicated directory under modules/home/ai/skills/<skill-name>, add a properly formatted SKILL.md file, commit the change via git, and apply it using home-manager switch. This repository-centric workflow ensures existing configurations remain untouched.

What is the correct SKILL.md frontmatter format for home-manager skill deployment?▼

The correct SKILL.md frontmatter format requires a YAML block containing the skill name and description fields. After the frontmatter, you write the skill content, which enables proper discovery metadata and consistent deployment when applying changes with home-manager switch.

Can I use git to version control AI skills in a Nix dotfiles repository?▼

Yes, git version control is an enforced part of the workflow for managing AI skills in a Nix dotfiles repository. You must stage and commit the new skill directory and SKILL.md file before applying the deployment, enabling peer review and clear versioning history.

Does home-manager switch apply new AI skills safely across different machines?▼

Home-manager switch applies new AI skills safely across machines by deploying from a centralized repository structure. By targeting the specific host with a flake reference, it ensures consistent and repeatable deployment without risking overwriting existing user configurations.

What's the best way to structure a Nix dotfiles repository for AI skill management?▼

The best way to structure a Nix dotfiles repository for AI skill management is to centralize all skills under modules/home/ai/skills/<skill-name>. This creates a repeatable deployment process, enforces clear discovery metadata, and maintains a versioned workflow for peer review.

Why do I need a repository-centric workflow for adding skills to home-manager?▼

A repository-centric workflow is needed for adding skills to home-manager because it consolidates directory placement, frontmatter formatting, and deployment into a repeatable process. This approach prevents configuration overwrites and enables versioning and peer review before applying changes.