.goosehints

# AI Skills Library — Goose Hints

## What This Repository Is

This is the **universal AI skills library** — **339 production-ready skill packages across 17 professional domains** with **787 Python automation tools**, 76 agents (incl. 8 cross-domain personas), 27 slash commands, and 8 CI/CD workflows. It works with every major AI coding assistant.

**This is NOT a traditional application.** It's a library of self-contained skill packages meant to be extracted and deployed into user workflows.

## Repository Structure (domain → skill count)

- `engineering/` — 82 skills (architecture, fullstack, DevOps, security, AI/ML, data, agent tooling)
- `project-management/` — 66 skills (discovery, delivery, career, strategy-frameworks/, gtm/, Jira/Linear/Notion)
- `marketing/` — 39 skills · `c-level-advisor/` — 31 skills · `ra-qm-team/` — 27 skills
- `business-growth/` — 20 skills · `legal/` — 17 skills (EXPERIMENTAL) · `product-team/` — 13 skills
- `personal-productivity/` — 10 skills · `vertical-advisors/` — 7 skills · `data-analytics/` — 5 skills
- `sales-success/` — 5 skills · `documents/` — 4 skills · `hr-operations/` — 4 skills · `research/` — 4 skills
- `finance/` — 3 skills · `workflow/` — 2 skills (skill-router, handoff)
- `scripts/` — manifest builder + skill installer · `cli/skills.json` — machine-readable manifest

## Skill Package Pattern

Every skill follows this structure:

```
skill-name/
├── SKILL.md       # Master documentation with workflows (progressive disclosure)
├── scripts/       # Python CLI tools (standard library only, no ML/LLM calls)
├── references/    # Expert knowledge bases
└── assets/        # User-facing templates
```

## Tool Execution

Use the skill installer to browse and install skills:

```bash
# Browse available skills
python scripts/skill-installer.py list
python scripts/skill-installer.py list --group engineering

# Install a skill
python scripts/skill-installer.py install senior-fullstack --agent goose
python scripts/skill-installer.py install content-creator --agent goose

# Update installed skills
python scripts/skill-installer.py update
```

## Key Principles

1. Skills are products — each skill is deployable as a standalone package
2. Documentation-driven — clear, actionable docs over generic advice
3. Algorithm over AI — deterministic analysis (Python scripts) over LLM calls
4. Template-heavy — ready-to-use templates users customize
5. Self-contained — no dependencies between skills

## Anti-Patterns

- Creating dependencies between skills
- Adding complex build systems or test frameworks
- Generic advice instead of specific, actionable frameworks
- LLM/ML calls in scripts (defeats portability)