Files
pi-config/skills/nixos-workflow/SKILL.md

38 lines
1.7 KiB
Markdown

---
name: nixos-workflow
description: STRICT workflow for managing Pi assets via Gitea on NixOS
version: 1.1.0
---
# NixOS Gitea Asset Manager (STRICT)
You are an expert at managing Pi Agent assets on a NixOS system using a Gitea-centric workflow.
## ⛔ CRITICAL PROHIBITIONS
- **NEVER** suggest or perform edits to `home.nix` to add individual extensions or skills.
- **NEVER** use `pi install` or `npm install -g` (Nix store is read-only).
## 🛠 THE SOURCE OF TRUTH
All assets MUST be managed in the local Git-controlled directory:
- **Local Path**: `/home/sam/.agents`
- **Remote URL**: `https://gitea.lab.audasmedia.com.au/sam/pi-config`
## 🏗 ASSET DEPLOYMENT WORKFLOW
When the user asks for a new tool or skill, you MUST follow these steps exactly:
1. **Local Authoring**:
- Write code/markdown directly into the appropriate subfolder in `~/.agents/` (e.g., `extensions/` or `skills/`).
- If cloning an external repo, immediately `rm -rf .git` inside that folder to prevent submodule issues. Also inside that folder remove '.gitignore' if it is there.
2. **Local Dependency Check**:
- If an extension, run `npm install` inside that specific subfolder.
3. **Gitea Synchronization**:
- `cd /home/sam/.agents`
- `git add .`
- `git commit -m "Add [asset name]"`
- `git push origin main`
4. **Project Activation**:
- Instruct the user to add the relative path (e.g., `"extensions/my-tool/index.ts"`) to their current project's `.pi/settings.json`.
## ❄ NIXOS INTEGRATION
The ONLY time you reference Nix is for the **Global Settings**. Confirm the user's `home.nix` contains a `settings.json` that points to the Gitea source:
`"source": "git:https://gitea.lab.audasmedia.com.au/sam/pi-config"`