Tables
Bundle OKF 0.2 · 5 conceitos · ghchinoy/agent-skills
Open source Repository Open in the app JSON README (API)
About
# Tables
* [Customer Orders](/tables/orders.md) - one row per completed customer order
* [Customers](/tables/customers.md) - one row per customer
# Metrics
* [Revenue](/metrics/revenue.md) - recognized revenue for a fiscal year
# Computations
* [Revenue computation](/computations/revenue.md) - sanctioned way to compute revenue
# References
* [Run a computation on BigQuery](/references/skills/run-on-bq.md) - executor run instructions
Details
- Kind
- OKF bundles
- Topic
- Cloud & DevOps
- Publisher
- ghchinoy
- Origin
- okf_github
- Category
- dados
- Version
- 0.2
- Stars
- 1
- Last push
- 2026-09-02T04:55:43Z
- Repository state
- ativo
- Language
- JavaScript
- License
- Apache-2.0
- Added
- 2026-09-08 09:02:43
- Updated
- 2026-09-08 09:02:43
- Origin id
ghchinoy/agent-skills:plugins/okf-authoring/skills/okf-author/assets/example-bundle/index.md
README
# Agent Skills & Plugins
Welcome to the `agent-skills` repository. This repository packages specialized expertise, procedural workflows, and task-specific capabilities according to two open standards:
- **[Agent Plugins Specification v1.0.0](https://agent-plugins.org)** — Distributable plugin packages bundled under `plugins/`.
- **[Agent Skills Specification](https://agentskills.io)** — Modular `SKILL.md` instruction sets providing on-demand expertise without polluting the model's immediate context window.
---
## Available Plugins & Skills
The repository is organized into 14 thematic plugins under `plugins/`:
### 1. 🎤 AI Pop (`plugins/ai-pop`)
*Virtual music artist production suite: lore planning, audio synthesis, visual design, and web player compilation.*
- **`ai-pop-producer`** (Primary Orchestrator): Coordinates sub-skills to generate artist profiles, album narratives, lyrics, cover art, track compositions, and web players.
- **`ai-pop-concept-planner`**: Drafts virtual artist backstories, mini-albums, theme-based color palettes, track metadata, and lyrics.
- **`ai-pop-audio-synthesizer`**: Composes high-fidelity music tracks via Google DeepMind Lyria.
- **`ai-pop-visual-designer`**: Generates cohesive album cover art and individual track illustrations using NanoBanana.
- **`ai-pop-compiler`**: Validates `artist.json` metadata, compiles TypeScript/Vite templates, and verifies static client builds using an embedded Go CLI scaffolder.
- **`ai-pop-publisher`**: Publishes compiled web player assets (`web/dist`) to a public hosting endpoint (Firebase Hosting or GCS static website bucket) and verifies liveness.
### 2. 🖥️ macOS HIG (`plugins/macos-hig`)
*macOS Human Interface Guidelines assistance and code reviewers.*
- **`macos-hig-layout`**: Guidelines for displays, ergonomics, multiple window states, and idiomatic SwiftUI `.windowResizability` limits.
- **`macos-hig-interaction`**: Guidelines for Menu Bar implementations (via SwiftUI `.commands`), Dock context menus, and high-precision inputs like `.onHover`.
- **`macos-hig-reviewer`**: Analyzes projects against Apple's Human Interface Guidelines, including custom `SwiftLint` rules to enforce macOS architectures.
### 3. 🩺 Beads Workflow (`plugins/beads-workflow`)
*Tools and workflows for the beads (`bd`) Dolt-powered issue tracking ecosystem.*
- **`bd-dolt-troubleshooter`**: Diagnoses and repairs `bd` issue-tracker problems (engine-mode mismatches, repo-ID errors, corrupt auto-backups, lock contention, hook-timeout stash-wipes, and schema version skew). Includes diagnostic and repair scripts.
- **`grill-with-beads`**: Grilling session that challenges your plan, sharpens work breakdown, and updates the `bd` issue tracker inline as decisions crystallise.
### 4. 📚 Repository Authoring (`plugins/repo-authoring`)
*Repository management skills for technical writing, README generation, changelogs, and commit recaps.*
- **`make-readme`**: Creates, assesses, and improves `README.md` files against a weighted quality rubric or strict `standard-readme` spec compliance.
- **`technical-post-editorial`**: Edits technical blog posts to remove AI writing patterns while preserving the author's human voice.
- **`repository-change-recap`**: Generates structured weekly or custom timeframe commit recaps using `git log --stat` and per-repo categorization rules (`.gemini/recap-rules.md`).
- **`changelog-manager`**: Generates, updates, and curates `CHANGELOG.md` files adhering to Keep a Changelog v1.1.0 and Common Changelog specs.
### 5. 🛡️ MCP Security (`plugins/mcp-security`)
*Model Context Protocol (MCP) security auditing for RCE, STDIO injection, and supply chain vulnerabilities.*
- **`mcp-auditor`**: Audits local MCP server configurations (Gemini CLI, Claude Desktop, Cursor) and custom-built MCP servers for Remote Command Execution (RCE) and STDIO transport injection as detailed in the OX Security Advisory. *(Includes sample reports in `references/`)*.
### 6. ⚙️ Agent-Aware CLI (`plugins/agent-aware-cli`)
*Best practices for CLI tools optimized for both human users and AI agents.*
- **`agent-aware-cli`**: Architecture guide covering Cobra/Viper in Go, machine-readable output formats, structured error codes, and flag conventions that AI agents can parse reliably.
### 7. 🔌 Agent Plugin Authoring (`plugins/agent-plugin-authoring`)
*Authoring, migration, and linting tools for packaging Agent Skills into Agent Plugins v1.0.0 specification packages.*
- **`skills-to-plugins`**: Audits flat skills repositories for conformance debt, groups co-dependent skills, generates `plugin.json` and `.claude-plugin/marketplace.json` manifests, and enforces spec containment rules. Includes audit, validation, and template assets.
### 8. 📖 OKF Authoring (`plugins/okf-authoring`)
*Tool-agnostic authoring and validation for conformant Open Knowledge Format (OKF) v0.2 knowledge bundles, including the v0.2 provenance, trust, and lifecycle vocabulary.*
- **`okf-author`**: Authors a conformant OKF v0.2 bundle by hand or from a description — one concept per markdown file with a required non-empty `type`, a root `index.md` declaring `okf_version`, bundle-relative links as relationship edges, and correct trust frontmatter (derives trust tiers, never stores a credibility score). Includes a complete example bundle.
- **`okf-validate`**: Checks §11 conformance and trust-signal well-formedness, reporting everything as advisories and never rejecting a bundle for optional, unknown, or broken content. Works fully by hand; opportunistically shells to `okfcli`/`binder`/`factile`/`openknowledge` when installed.
### 9. ⚖️ Automation Governance (`plugins/automation-governance`)
*Framework and tooling for evaluating workflow, skill, and process automation readiness based on Google DeepMind research.*
- **`automation-readiness`**: Evaluates candidates against Google DeepMind's *Intelligent AI Delegation* framework (arXiv:2602.11865) using an 11-axis diagnostic scorecard, hard gate veto overrides, 4 automation tiers (Full Autonomy, Monitored, HITL, Human-Led), and an operational guardrail matrix. Includes scoring engine (`scripts/score.py`), scorecard rubric, and comprehensive framework reference.
### 10. ☁️ GCP Management (`plugins/gcp-management`)
*Google Cloud Platform & Firebase portfolio assessment, itemized BigQuery cost analysis, quota governance, and project consolidation.*
- **`gcp-project-assessment`**: Audits and categorizes 60+ GCP/Firebase projects across billing links, active compute, 30-day Cloud Logging traffic, BigQuery billing export spend, and Firebase assets. Produces structured Markdown reports with Mermaid cost diagrams. Includes parallelized audit script (`scripts/audit_portfolio.py`) and SQL queries (`references/billing-export-queries.sql`).
- **`gcp-quota-governance`**: Analyzes API spend velocity (e.g. Vertex AI frontier Claude & Gemini models) and establishes enforceable hard request/token quotas, Cloud Run scaling caps, and event-driven automated billing circuit breakers. Includes quota inspector script (`scripts/inspect_quotas.py`), capping reference guide, and circuit breaker architecture.
- **`gcp-project-consolidation`**: Guides the identification, cleanup, and consolidation of duplicate environments, orphaned persistent disks on terminated VMs, unattached static IPs, deletion lien removals, and safe project retirement. Includes decommissioning checklists and orphaned resource playbooks.
### 11. 🐹 Go Readability (`plugins/go-readability`)
*Modern Go and Google readability standards, style guidelines, code review checklists, and testing patterns.*
- **`go-readability`**: Write and review Go code to meet modern Go and Google readability standards. Covers style, naming, error handling, testing, documentation, package design, linting, mentor feedback, and CLI checklists. Includes 7 deep-dive reference guides and before/after review examples.
### 12. 🏎️ macOS Performance (`plugins/macos-performance`)
*macOS/SwiftUI application performance assessment for launch responsiveness and runtime smoothness.*
- **`quick-bounce-assessor`**: Assesses first-frame ("quick bounce") readiness by finding synchronous main-actor I/O on the launch path, Swift strict-concurrency posture, view-model vs business-logic separation, and steady-state render budget (high-frequency `@Published` timers, per-body allocations). Produces a PASS/WARNING/FAIL report with `file:line` evidence and phased fixes. Includes a read-only heuristic scanner (`scripts/scan_launch_path.sh`) and an anti-pattern catalog (`references/PERF_CATALOG.md`).
### 13. 🎨 Brand Identity (`plugins/brand-identity`)
*Brand identity extraction, DESIGN.md design system synthesis, and brand-consistent image generation.*
- **`brand-extractor`**: Crawls target websites, captures high-fidelity viewport/full-page screenshots, extracts computed CSS styles and `:root` custom properties, and synthesizes structured Brand DNA and a Google Labs `DESIGN.md` Alpha specification. Includes extraction script (`scripts/extract_brand_dna.py`) and validator (`scripts/validate_design_md.py`).
- **`brand-image-generator`**: Translates `DESIGN.md` specifications and Brand DNA into evocative, style-adherent prompts and coordinates generative AI image creation. Includes prompt formatter (`scripts/format_image_prompt.py`), prompt recipes, and crafting guide.
### 14. 🛡️ C2PA Inspector (`plugins/c2pa-inspector`)
*C2PA Content Credentials inspection, cryptographic verification, and batch auditing.*
- **`c2pa-inspect`**: Audits single media assets, batches, or directories for C2PA Content Credentials, cryptographic signatures, provenance assertions, AI generation metadata, and digital tampering. Built on Google Credentio data models and C-ABI wrapper architecture with a pure-Python container fallback. Includes dual-engine inspector CLI (`scripts/inspect_c2pa.py`), prebuilt native library fetcher (`scripts/fetch_native_lib.sh`), C2PA specification guides, and sample fixtures.
---
## Installation & Usage
### Installing via Open Agent Skills CLI (`npx skills`)
The [Open Agent Skills CLI](https://github.com/vercel-labs/skills) works natively with this repository via `.claude-plugin/marketplace.json`:
```bash
# List available skills in the repository
npx skills add ghchinoy/agent-skills --list
# Install a specific skill (e.g., mcp-auditor)
npx skills add ghchinoy/agent-skills --skill mcp-auditor
# Install all skills to your project
npx skills add ghchinoy/agent-skills --all
```
### Using via Gemini CLI
```bash
# Install a specific skill directly from GitHub
gemini skills install ghchinoy/agent-skills --path plugins/beads-workflow/skills/bd-dolt-troubleshooter
# Clone and link locally
git clone https://github.com/ghchinoy/agent-skills.git
gemini skills link ./agent-skills/plugins/beads-workflow/skills/bd-dolt-troubleshooter
```
### Using via Antigravity CLI (`agy`)
Copy or link the desired plugin or skill directory into your workspace:
```bash
# Global scope
cp -R plugins/ai-pop/skills/* ~/.gemini/antigravity/skills/
# Project scope
cp -R plugins/ai-pop/skills/* .agents/skills/
```
---
## Repository Validation
To run local validation across all plugin manifests (`plugin.json`), skill frontmatter (`SKILL.md`), executable script bits, and marketplace indexing:
```bash
./scripts/validate-plugins.sh
```
---
## License
This repository is licensed under the [Apache License 2.0](LICENSE).