# Agent Skill Observatory v0.2.0

> Evidence-based discovery, specification validation, static security analysis, and multi-dimensional
> ranking for open Agent Skills across Claude Code, OpenAI Codex, Google Antigravity, Cursor,
> Windsurf, OpenCode, and Skills.sh.

Author: Mamdouh Aboammar <mamdouhfces1997@gmail.com>
Copyright: © 2026 Mamdouh Aboammar. All rights reserved.
License: Apache-2.0
Version: 0.2.0
Repository: https://github.com/imMamdouhaboammar/agent-skill-observatory
Live Catalog: https://imMamdouhaboammar.github.io/agent-skill-observatory/

## Key Endpoints & Resources
- [Full Documentation for LLMs](https://imMamdouhaboammar.github.io/agent-skill-observatory/llms-full.txt): Complete technical specification, schema, and security model.
- [JSON Catalog Data](https://imMamdouhaboammar.github.io/agent-skill-observatory/catalog.json): Machine-readable array of all indexed skills with quality and security scores.
- [Catalog Statistics](https://imMamdouhaboammar.github.io/agent-skill-observatory/stats.json): Aggregated repository metrics and compliance rates.
- [Architecture Guide](https://github.com/imMamdouhaboammar/agent-skill-observatory/blob/main/docs/architecture.md): High-level system design and data pipeline.
- [Security Model](https://github.com/imMamdouhaboammar/agent-skill-observatory/blob/main/docs/security-model.md): Threat vectors, zero-execution invariant, and static analysis boundaries.
- [OmniSkill Integration](https://github.com/imMamdouhaboammar/agent-skill-observatory/blob/main/docs/omni-skill-integration.md): Host profiles, routing DAG, and multi-agent distribution.
- [Scoring Model](https://github.com/imMamdouhaboammar/agent-skill-observatory/blob/main/docs/scoring.md): Calibration tables, formula pseudocode, and evidence factors.

## Core Capabilities
- `skillobs scan-local <path>`: Statically audits a local skill directory before installation.
- `skillobs refresh`: Discovers and indexes skills from GitHub trees and code search without executing remote code.
- `skillobs build-site`: Exports catalog artifacts and static web dashboard for GitHub Pages.
- `skillobs serve`: Launches FastAPI REST service on port 8000 with `/api/v1/skills`, `/api/v1/stats`, and interactive UI.

## OmniSkill Multi-Agent Support (v0.2.0)
This observatory skill adheres to the OmniSkill universal standard and is distributed to:
Antigravity / Gemini CLI, Claude Code, Cursor, Codex, OpenCode, Skills.sh.