Agentic Skill Marketplace — Unified Implementation

# Agentic Skill Marketplace

OpsML is the enterprise hub for globally shareable, versionable agentic artifacts — skills, tools, agents, workflows — usable across Claude Code, Codex, Gemini CLI, and GitHub Copilot CLI.

## Overview

This issue tracks the unified implementation of the Agentic Skill Marketplace. Two complementary delivery modes:

- **Eager**: `opsml skill pull` downloads artifacts to repo directories
- **Lazy**: `.opsml-skills.yaml` + startup hook + `/v1/` routes fetches from registry on demand

Each OpsML instance hosts its own private Skill Marketplace (enterprise model — no public SaaS layer). The Marketplace UI is the discovery layer on top of the registry and the foundation for a future no-code agent composer.

## Dependency Graph

```
PR 1 (Types + SQL) ✅
└── PR 1.1 (GithubCopilotCli + input_schema + download_count) ✅
└── PR 2 Server Routes + Registry + Python Bindings + /v1/ Content Routes
└── PR 3 Synchronous skill scan agent
├── PR 4 CLI Skill Commands
├── PR 5 Lazy Registry Types
│ └── PR 6 CLI Configure + Skill Sync
├── PR 7 Enrich AgentSpec
│ └── PR 8 WorkflowSpec + ServiceType::Workflow
│ └── PR 9 Run Manifest Generation
├── PR 10 Skill Marketplace UI
│ └── PR 11 Workflow UI + Agent config browser
├── PR 12 CLAUDE.md Generator
└── PR 13 Usage Analytics + Audit
```

## Recommended Build Order

1 → 1.1 → 2 → 3 → 3.5 → 4 → 5 → 6 → 7 → 8 → 10 → (then 9, 11, 12, 13 in any order)

## Sub-Issues

- #350 [PR 2] SkillCard PyO3 Struct
- #351 [PR 3] Server Routes + Registry + Python Bindings + /v1/ Content Routes
- #352 [PR 3.5] Synchronous Skill Scan Agent
- #353 [PR 4] CLI Skill Commands (push / pull / list / init)
- #354 [PR 5] Lazy Registry Types (OpsmlSkillsYaml + CacheManifest)
- #355 [PR 6] CLI Configure + Skill Sync (Eager + Lazy, All 4 CLIs)
- #356 [PR 7] Enrich AgentSpec (Tools, Hooks, Model Config, Permissions, Display)
- #357 [PR 8] WorkflowSpec + ServiceType::Workflow
- #358 [PR 9] Run Manifest Generation
- #359 [PR 10] Skill Marketplace UI
- #360 [PR 11] Workflow UI + Agent Configuration Browser
- #361 [PR 12] CLAUDE.md Generator
- #362 [PR 13] Usage Analytics + Audit

## Completion Criteria

- All PRs merged
- Full test suite passing: `make lints && make test.unit`
- Python tests passing: `cd py-opsml && make lints && make test.unit`
- Skill Marketplace UI functional at `/opsml/genai/marketplace/`
- All four CLI targets (Claude Code, Codex, Gemini CLI, GitHub Copilot CLI) working

This is an umbrella roadmap rather than a self-contained task; start with the first incomplete dependency, sub-issue #350, then follow the stated build order through the server routes, CLI commands, lazy registry, and marketplace UI. Use the named `/v1/` routes, `.opsml-skills.yaml`, CLI targets, and marketplace path as entry points, and verify completion with the listed lint, unit-test, UI, and four-CLI criteria.

Written by the indexing model from the issue text.