skills.rest
SpreadZhao
SpreadZhaoCOMMUNITY
Explore all skills by this author →
GitHub

spreadconfig-skill-authoring

Create and register Nix-managed skills in the spreadconfig repository.

4|Updated May 20, 2024
Search Tags:#nix#skill authoring#flakes#nixos#agent-skills#home-manager#declarative configuration
One-click install
npx skills add https://github.com/SpreadZhao/spreadconfig --skill spreadconfig-skill-authoring-spreadzhao
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spreadconfig-skill-authoring
Source: https://github.com/SpreadZhao/spreadconfig/tree/main/skills/local/spreadconfig-skill-authoring
Command: npx skills add https://github.com/SpreadZhao/spreadconfig --skill spreadconfig-skill-authoring-spreadzhao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It guides the creation and maintenance of skills whose source of truth is the spreadconfig NixOS repository, preventing direct edits to installed skill symlinks and ensuring declarative registration through Home Manager and agent-skills. ## Core Features & Use Cases - Local Skill Creation: Scaffolds new skills under skills/local with the skill-creator initializer, aligned agents/openai.yaml metadata, and lowercase hyphen-case naming. - Declarative Registration: Registers skills in skills/sources.nix with localSkillSource, agentTargets, skillSets, workspaceProfiles, and globalSkills exposure. - Safe Update Workflow: Distinguishes content-only edits from profile or global exposure changes, and defers Home Manager switches to the user. - Use Case: When asked to add a new skill for a NixOS workspace, it creates the skill directory, wires it into sources.nix, assigns it to a workspace profile, validates it with quick_validate.py, and reports that a Home Manager switch is required. ## Quick Start Use $spreadconfig-skill-authoring to create a new skill named my-tool in spreadconfig and register it for my workspace profile.

Frequently Asked Questions about spreadconfig-skill-authoring

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

FAQPage Schema
How do I create a new skill in a Nix-managed repository?▼

Create a lowercase hyphen-case directory under skills/local, run the skill-creator init_skill.py initializer, fill in SKILL.md and agents/openai.yaml, then register it in skills/sources.nix using localSkillSource and add it to skillSets and a workspace profile.

How do I register a skill with Home Manager and agent-skills?▼

Add an entry in skills/sources.nix with a source and targets such as agentTargets, inherit it in skillSets, then list it in workspaceProfiles for dynamic use or globalSkills for home-wide installs. A Home Manager switch regenerates symlinks and the profile manifest.

Can I edit installed skill files in ~/.claude/skills directly?▼

No. Installed locations like ~/.agents/skills, ~/.claude/skills, and ~/.codex/skills are symlinks managed by Home Manager. Edit the declarative source under skills/local or fix the profile entry in skills/sources.nix instead.

Why is my new skill file invisible to Nix flake evaluation?▼

Git-backed flakes only see tracked files, so newly created skill files are invisible until staged. Stage only the relevant new skill files and registry changes with git add, leaving unrelated dirty work untouched.

When is a Home Manager switch required after changing a skill?▼

Content-only edits to an already linked local skill take effect immediately. Changes to globalSkills or workspaceProfiles require a Home Manager switch, followed by agent-skills refresh to reapply active profiles.

Related Skills

Explore More Software Engineering Skills→
olafkfreundolafkfreund
21

niri

Configure Niri on NixOS with Home Manager for scrollable-tiling Wayland desktops.

Community
Advanced
openakitaopenakita
2.0k

load-skill

Load newly created skills from the local skills directory into the running system.

Community
Basic
rafazshrafazsh

Skill Development

Create and improve Claude Code plugin skills with structured metadata.

Community
Intermediate
Rabbit-IvanRabbit-Ivan

.agents

Documents repository structure and maintenance conventions for a centralized AI agent skills collection.

Community
Basic