Skip to content

Add workstation skill library with categories and tags#342

Open
naiam-studio wants to merge 5 commits into
AbdelStark:mainfrom
naiam-studio:feat/workstation-skills-library
Open

Add workstation skill library with categories and tags#342
naiam-studio wants to merge 5 commits into
AbdelStark:mainfrom
naiam-studio:feat/workstation-skills-library

Conversation

@naiam-studio

Copy link
Copy Markdown

Summary

Add a Unix-like organized skill library under .workstation/skills/ with:

  • 13 category directories with symlink-based references
  • YAML frontmatter tags for filtering (Markdown_TAG compatible)
  • workstation-navigation meta-skill for optimal search protocol
  • 31 incorporated skills capturing repo-specific wisdom and practices
  • Reference in AGENTS.md and CLAUDE.md for agent discovery

Motivation

Agents need a fast, organized way to find relevant skills without reading every SKILL.md file. The library uses Unix-like directory structure where categories contain symlinks to canonical sources, making it trivial to add new skills or create custom views.

Structure

.workstation/skills/
├── all/           → 59 symlinks (everything)
├── for-agents/    → 59 symlinks (agent-useful subset)
├── incorporated/  → 31 symlinks (skills we created)
├── sources/       → canonical content (worldforge/, gentle-ai/, incorporated/)
├── codex/         → 7 symlinks (WorldForge project skills)
├── sdd/           → 11 symlinks (SDD workflow skills)
├── review/        → 7 symlinks (review patterns)
├── docs/          → 4 symlinks (documentation skills)
├── testing/       → 10 symlinks (testing patterns)
├── provider/      → 5 symlinks (provider skills)
├── security/      → 1 symlink (security skills)
├── convention/    → 7 symlinks (conventions)
├── workflow/      → 3 symlinks (workflow skills)
├── git/           → 6 symlinks (git/PR skills)
└── config/        → 3 symlinks (config files)

Changes

File Change
.workstation/README.md Top-level docs (dynamic, no counts)
.workstation/skills/README.md Full catalog docs (dynamic, no counts)
.workstation/skills/sources/incorporated/ 31 canonical skill directories
.workstation/skills/sources/worldforge/ 7 WorldForge project skills
.workstation/skills/sources/gentle-ai/ 21 Gentle AI global skills
.workstation/skills/all/ 59 symlinks to every skill
.workstation/skills/incorporated/ 31 symlinks to incorporated skills
.workstation/skills/for-agents/ 59 symlinks (superset)
.workstation/skills/config/ symlinks to config files
AGENTS.md Added .workstation/ reference in Documentation Map
CLAUDE.md Added .workstation/skills/ in structure, layering, and skills

Test Plan

  • All symlinks are relative (portable within repository)
  • No broken symlinks (verified with find -xtype l)
  • Ruff check passed (no Python files in .workstation)
  • AGENTS.md updated with .workstation reference
  • CLAUDE.md updated with .workstation reference

Organized skill library for AI agent workflows with Unix-like structure:
- 13 category directories with symlink-based references
- YAML frontmatter tags for filtering (Markdown_TAG compatible)
- workstation-navigation meta-skill for optimal search protocol
- Incorporated skills capturing repo-specific wisdom and practices
- Reference in AGENTS.md and CLAUDE.md for agent discovery
@naiam-studio naiam-studio requested a review from AbdelStark as a code owner June 26, 2026 09:56
- Move all skills to naiam-studio/my-skills repo
- Add .engram-personal symlink for portable memory layer
- Add .workstation/skills symlink to my-skills repo
- Update .gitignore to exclude installed directories
- Remove tracked content (kept locally via symlinks)
- Restore shared skills (worldforge, gentle-ai, incorporated)
- Add .personal symlink to my-skills (gitignored)
- Update .gitignore to exclude personal directories
- Other devs get shared skills, personal stays hidden
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant