# AI Workflow Skills Explorer Plan

Canonical page: https://ozbejbohanec.com/ai-workflow/
Source repository: https://gitlab.com/ozbej.bohanec/ai-workflow
Source directory: `skills/*/SKILL.md`

## Purpose

Expose the custom Codex skills from the `ai-workflow` repository as a public, inspectable, and downloadable skills catalog.

The page should make the repository easier to understand without pretending to be a full file browser.

## Scope

- Show only skills that exist in `ai-workflow/skills/*/SKILL.md`.
- Keep each skill tied to its source path.
- Provide search and category filters.
- Show a selected skill's purpose, trigger context, category, and GitLab source path.
- Provide this Markdown plan as both a downloadable file and visible source code on the page.

## Skills Included

- `codex-runtime-enforcement`
- `codex-sync`
- `deepsec`
- `domain-modeling`
- `git-workflow`
- `grill-me`
- `grill-with-docs`
- `grilling`
- `history-lookup`
- `migration-safety`
- `ollama-triage`
- `readonly-guard`
- `release-freeze-mode`
- `repo-improvement`
- `roast`
- `security-best-practices`
- `session-handoff`
- `workflow-audit`
- `workflow-idea-council`
- `workflow-improvement-council`

## Interaction Model

1. The user opens `/ai-workflow/`.
2. The left panel lists the real skills from the repository.
3. Search filters the list by skill name or category.
4. Category buttons narrow the visible list.
5. Selecting a skill updates:
   - the active tree row,
   - the editor tab path,
   - the detail panel,
   - the inspector panel,
   - the status text.
6. The Markdown plan section offers:
   - direct download,
   - direct source view,
   - inline source preview loaded from this same `.md` file.

## Data Boundary

The public page must not expose private overlays, local credentials, internal incidents, private GitLab tokens, account screenshots, or generated private evidence.

## Verification

- SEO validator must pass.
- JSON-LD must parse.
- Search must filter the skill list.
- Clicking a skill must update the detail and inspector panels.
- Mobile layout must not create horizontal overflow.
- Docker build must succeed for deployment packaging.