Initial skills collection

README.md

@@ -0,0 +1,64 @@
+# LLM Agent Skills
+
+A personal collection of reusable skills for LLM coding agents.
+
+Skills are small, focused instruction packs that teach an agent how to perform a
+specific workflow consistently. A good skill captures the judgment, conventions,
+commands, file layout, and verification steps that should be reused across
+projects.
+
+## Goals
+
+- Keep useful agent workflows portable across machines and projects.
+- Capture repeatable setup, debugging, writing, and automation patterns.
+- Prefer concise instructions over large prompt dumps.
+- Make skills easy to inspect, edit, and version.
+- Treat skills as living documentation for how I like agents to work.
+
+## Repository Layout
+
+```text
+skills/
+  README.md
+  skills/
+    example-skill/
+      SKILL.md
+```
+
+Each skill should live in its own directory and include a `SKILL.md` file.
+Supporting scripts, templates, references, or assets can live next to that file
+when they make the skill easier to use.
+
+## Skill Format
+
+A minimal skill should include:
+
+- A short name and description.
+- When the skill should be used.
+- The workflow the agent should follow.
+- Any commands, scripts, or files the agent should prefer.
+- Verification steps, if the skill changes files or system state.
+
+## Example
+
+```text
+skills/
+  macos-setup/
+    SKILL.md
+    scripts/
+      apply-defaults.sh
+```
+
+## Writing Principles
+
+- Be specific about triggers.
+- Keep instructions operational.
+- Prefer checklists and concrete commands.
+- Avoid vague personality guidance.
+- Include safety notes for destructive or irreversible steps.
+- Keep generated artifacts and scratch work out of the repo unless they are part
+  of the skill.
+
+## License
+
+Unlicensed for now. Add a license later if these skills become public or shared.