Skip to content

Instantly share code, notes, and snippets.

@kennethnwc
Created January 26, 2026 04:55
Show Gist options
  • Select an option

  • Save kennethnwc/9b4e4c0d855abc23e6479384bf0f436b to your computer and use it in GitHub Desktop.

Select an option

Save kennethnwc/9b4e4c0d855abc23e6479384bf0f436b to your computer and use it in GitHub Desktop.
Bootstrap skill

Set Up Skills Infrastructure

Create a skills system for this project to help AI agents learn and retain project-specific knowledge.

Create this file:

skills/SKILLS.md

# Project Skills

## Available Skills

(None yet - skills will be added as patterns emerge)

## Auto-Update Policy

When encountering new patterns worth documenting:

**Add to existing skill:**
1. Add to relevant skill's `references/` folder
2. Update the skill's `SKILL.md` Quick Reference table

**Create new skill:**

skills/my-skill/ ├── SKILL.md # Required: instructions + metadata ├── references/ # Optional: detailed docs

Then update this index.

Done!

That's the minimal setup. Create skills only when patterns emerge - don't pre-plan.


Reference (for later use)

When to create a skill:

  • Explaining the same thing multiple times
  • Hitting the same gotcha repeatedly
  • Following a non-obvious workflow

Skill template:

---
name: skill-name
description: One line about when to use this skill.
---

# Skill Name

## When to Use

- Trigger situation 1
- Trigger situation 2

## Quick Reference

| Question | Answer |
|----------|--------|
| How do I X? | Do Y |

Growing a skill:

Level 1: Single file
skills/my-skill/
└── SKILL.md

Level 2: Add references when file gets long
skills/my-skill/
├── SKILL.md
└── references/
    └── DETAILS.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment