Metadata-Version: 2.5
Name: vibey-skills
Version: 2.1.0
Summary: Agent Skills for vibe engineering — 71 evidence-grounded practitioner references as a Claude Code plugin marketplace
Project-URL: Homepage, https://adammatthewsteinberger.github.io/vibey-skills/
Project-URL: Documentation, https://adammatthewsteinberger.github.io/vibey-skills/
Project-URL: Repository, https://github.com/adammatthewsteinberger/vibey-skills
Project-URL: Issues, https://github.com/adammatthewsteinberger/vibey-skills/issues
Project-URL: Changelog, https://github.com/adammatthewsteinberger/vibey-skills/releases
Author-email: Adam Matthew Steinberger <adam@matthewsteinberger.com>
Maintainer-email: Adam Matthew Steinberger <adam@matthewsteinberger.com>
License-Expression: MIT
License-File: LICENSE
License-File: NOTICE.md
Keywords: agent-skills,ai-agents,azure,claude,claude-code,developer-tools,devsecops,llm,plugin-marketplace,prompt-engineering,security,skills
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Documentation
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Provides-Extra: docs
Requires-Dist: mkdocs-gen-files>=0.5; extra == 'docs'
Requires-Dist: mkdocs-literate-nav>=0.6; extra == 'docs'
Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
Description-Content-Type: text/markdown

# vibey-skills

> **18 Claude Code plugins. 71 Agent Skills.** Long-form, source-cited practitioner
> references for the parts of software engineering an agent is most likely to get
> confidently wrong — security, compliance, Azure, identity automation (Okta),
> DevSecOps, AI/ML, data engineering, frontend, mobile, architecture, quality
> engineering, process, and technical writing. Install as a marketplace or from PyPI.

Formerly **vibe-engineering-skills** — see [NOTICE.md](https://github.com/adammatthewsteinberger/vibey-skills/blob/main/NOTICE.md).

[![PyPI](https://img.shields.io/pypi/v/vibey-skills.svg)](https://pypi.org/project/vibey-skills/)
[![Downloads](https://img.shields.io/pypi/dm/vibey-skills.svg)](https://pypi.org/project/vibey-skills/)
[![CI](https://github.com/adammatthewsteinberger/vibey-skills/actions/workflows/ci.yml/badge.svg)](https://github.com/adammatthewsteinberger/vibey-skills/actions/workflows/ci.yml)
[![Docs](https://github.com/adammatthewsteinberger/vibey-skills/actions/workflows/docs.yml/badge.svg)](https://adammatthewsteinberger.github.io/vibey-skills/)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/adammatthewsteinberger/vibey-skills/blob/main/LICENSE)

## Why

"Vibe engineering" is the disciplined counterpart to vibe coding: keep the agent
fast *and* correct. These skills are the reference layer for that.

- **Each skill is a document, not a prompt snippet.** A `SKILL.md` is a long-form,
  source-cited reference (STRIDE → MITRE ATT&CK, NIST 800-171 control families,
  Okta Workflows record caps, React Native New Architecture) written so a model can
  act on it. Claude loads it automatically when a task matches the trigger description.
- **One source of truth.** `plugins/` is the marketplace tree Claude Code reads; the
  PyPI wheel maps that same tree in at build time. There is exactly one copy of every skill.
- **Zero runtime dependencies.** `uvx` runs the CLI with no resolution step. Skills
  install into `~/.claude/skills`, which any harness that reads `SKILL.md` can use.
- **Nothing overwritten.** `install` skips skill directories that already exist and
  tells you which; `--force` is explicit.

## Quick start

**In Claude Code** — add the marketplace, then install the plugins you want:

```bash
/plugin marketplace add adammatthewsteinberger/vibey-skills
/plugin install security-principles@vibey-skills
/plugin                                    # browse everything
```

**From PyPI** — same skills, any agent that reads `SKILL.md`:

```bash
uvx vibey-skills list                      # try it without installing
uvx vibey-skills install --all             # copy all 71 skills into ~/.claude/skills
uvx vibey-skills install security-principles azure-cloud-infra
```

Or install the CLI permanently with `uv tool install vibey-skills` /
`pip install vibey-skills` (Python 3.10+); `vibey-skills` is then on your PATH
(`vibe-skills` still works as a deprecated alias).

```console
$ vibey-skills list
agile-delivery  (0.1.0, engineering-process, 3 skills)
  - delivery-velocity
  - engineering-metrics
  - security-first-agile

ai-and-data  (0.2.0, ai, 4 skills)
  - ai-ml-landscape
  - data-engineering
  - llm-cost-optimization
  - rag-and-agents
…
```

`vibey-skills marketplace` prints the packaged manifest path for `/plugin marketplace add`;
`--dest`, `--link`, `--dry-run`, and `--force` are covered in the
[Usage docs](https://adammatthewsteinberger.github.io/vibey-skills/usage/).

### Migrating from vibe-engineering-skills

2.0.0 renames the project; the 18 plugins and 71 skills are unchanged.

| | 1.x (`vibe-engineering-skills`) | 2.0.0 (`vibey-skills`) |
|---|---|---|
| PyPI package | `pip install vibe-engineering-skills` | `pip install vibey-skills` |
| Python import | `import vibe_engineering_skills` | `import vibey_skills` |
| CLI | `vibe-engineering-skills`, `vibe-skills` | `vibey-skills` (`vibe-skills` kept as a deprecated alias; the long form is gone) |
| Marketplace | `/plugin marketplace add TheViziusGroup/vibe-engineering-skills` | `/plugin marketplace add adammatthewsteinberger/vibey-skills` |
| Plugin install | `<plugin>@vibe-engineering-skills` | `<plugin>@vibey-skills` |
| Docs | theviziusgroup.github.io/vibe-engineering-skills | [adammatthewsteinberger.github.io/vibey-skills](https://adammatthewsteinberger.github.io/vibey-skills/) |

Uninstall the old package (`pip uninstall vibe-engineering-skills` / `uv tool uninstall
vibe-engineering-skills`) and re-add the marketplace under its new name; skills already
copied into `~/.claude/skills` need no change.

## Plugins

Generated from `plugins/*/` and `.claude-plugin/marketplace.json`; every plugin has its
own `README.md` with the full skill list and trigger descriptions.

| Plugin | Version | Category | Skills | Covers |
|---|---|---|---|---|
| [agile-delivery](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/agile-delivery) | 0.1.0 | engineering-process | 3 | Security-First Scrum, delivery velocity, engineering metrics |
| [ai-and-data](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/ai-and-data) | 0.2.0 | ai | 4 | Data engineering, AI/ML landscape, RAG & agents, LLM cost optimization & compression |
| [ai-chatbot-strategy](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/ai-chatbot-strategy) | 0.1.0 | ai | 4 | Chatbot fundamentals, RAG for business, build/deploy, ROI |
| [vibey-bootstrap](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/vibey-bootstrap) | 0.3.0 | cloud-infrastructure | 4 | The [vibey-bootstrap](https://github.com/adammatthewsteinberger/vibey-bootstrap) library (v4.0.0, formerly `azure-bootstrap`): 4-phase bootstrap, v2 primitives, ten logging transports, subpackages, v3 DB/email/HTTP/AKS/governance/scaffold, TypeScript integration |
| [azure-cloud-infra](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/azure-cloud-infra) | 0.2.0 | cloud-infrastructure | 3 | Azure RBAC, Kubernetes IaC, Azure service catalog |
| [compliance-frameworks](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/compliance-frameworks) | 0.1.0 | security | 5 | NIST 800-171, PCI-DSS v4, SOC 2, CMMC/CUI, OWASP SAMM |
| [devsecops-cicd](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/devsecops-cicd) | 0.2.0 | devops | 4 | DevSecOps pipelines, Bitbucket/Azure, CI/CD field guide, GitHub/Atlassian |
| [engineering-process](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/engineering-process) | 0.1.0 | engineering-process | 4 | Requirements, SDLC, process engineering, research methodology |
| [frontend-design](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/frontend-design) | 0.1.0 | frontend | 3 | Graphic/UX/UI design, Next.js patterns, performance optimization |
| [mobile-development](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/mobile-development) | 0.1.0 | frontend | 5 | React Native New Architecture, native iOS/Android, mobile UI/UX & patterns, Azure hosting/Intune/CI-CD, mobile security & MFA |
| [network-engineering](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/network-engineering) | 0.1.0 | cloud-infrastructure | 2 | Network fundamentals, modern stack (eBPF, Cilium, AKS) |
| [okta-api-reference](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/okta-api-reference) | 0.1.0 | cloud-infrastructure | 3 | Okta core Management API & Python SDK, Identity Governance (OIG) API surface, MCP server landscape for Okta core and IGA automation |
| [okta-workflows](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/okta-workflows) | 0.1.0 | cloud-infrastructure | 9 | Okta Workflows field guide for identity source-of-truth → Okta sync: branching, loops, Tables, hooks/streaming, Okta & Entra connectors, execution limits, error handling, flopack deployment — quirks, caps & verified workarounds |
| [quality-engineering](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/quality-engineering) | 0.2.0 | engineering-process | 3 | Python testing, test strategy, debugging & observability |
| [security-first-dev](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/security-first-dev) | 0.1.0 | security | 3 | Security-First Scrum, codebase modernization, cybersecurity implementation |
| [security-principles](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/security-principles) | 0.2.0 | security | 4 | Cybersecurity principles, threat modeling, AI-era security, AI safety |
| [software-architecture](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/software-architecture) | 0.2.0 | engineering-process | 3 | Production architecture, architecture patterns, software design |
| [writing-craft](https://github.com/adammatthewsteinberger/vibey-skills/tree/main/plugins/writing-craft) | 0.1.0 | content | 5 | White papers, prose mechanics, technical prose, narrative, legal briefs |

Browse every skill's full text on the
[Skills reference](https://adammatthewsteinberger.github.io/vibey-skills/reference/).

## How it works

```
.claude-plugin/marketplace.json         Marketplace manifest — the entry point Claude Code reads
plugins/<plugin>/.claude-plugin/plugin.json   Plugin manifest
plugins/<plugin>/README.md              Plugin overview + skill list
plugins/<plugin>/skills/<skill>/SKILL.md      One skill: YAML frontmatter (name, trigger) + the reference
src/vibey_skills/                       Python package + `vibey-skills` CLI (stdlib only)
tools/validate_manifests.py             Manifest and skill-frontmatter validator
tools/check_links.py                    Hermetic link checker (README is also the PyPI long description)
```

CI validates every manifest and frontmatter, checks that the built wheel carries every
`SKILL.md`, smoke-tests `vibey-skills install --all` from the wheel, and builds the docs
site with `mkdocs build --strict` so a dead link on any of the 71 generated pages fails
the build.

## Docs & links

- **[Documentation site](https://adammatthewsteinberger.github.io/vibey-skills/)** — [Installation](https://adammatthewsteinberger.github.io/vibey-skills/installation/) · [Usage](https://adammatthewsteinberger.github.io/vibey-skills/usage/) · [Skills reference](https://adammatthewsteinberger.github.io/vibey-skills/reference/) (one page per plugin and per skill)
- **[PyPI](https://pypi.org/project/vibey-skills/)** · **[Releases](https://github.com/adammatthewsteinberger/vibey-skills/releases)** · **[Issues](https://github.com/adammatthewsteinberger/vibey-skills/issues)**
- **[CONTRIBUTING.md](https://github.com/adammatthewsteinberger/vibey-skills/blob/main/CONTRIBUTING.md)** · **[SECURITY.md](https://github.com/adammatthewsteinberger/vibey-skills/blob/main/SECURITY.md)** · **[CODE_OF_CONDUCT.md](https://github.com/adammatthewsteinberger/vibey-skills/blob/main/CODE_OF_CONDUCT.md)** · **[CLAUDE.md](https://github.com/adammatthewsteinberger/vibey-skills/blob/main/CLAUDE.md)** (conventions and the `SKILL.md` format)
- Claude Code docs: [Plugins](https://code.claude.com/docs/en/plugins) · [Plugin marketplaces](https://code.claude.com/docs/en/plugin-marketplaces) · [Agent Skills](https://code.claude.com/docs/en/skills)

## Related projects

Part of the same open-source family — MIT, on PyPI:

- **[engineering-influence-skills](https://github.com/adammatthewsteinberger/engineering-influence-skills)** — companion plugin: a 14-phase content-engineering pipeline for long-form writing
- **[claudeloop](https://github.com/adammatthewsteinberger/claudeloop)** · **[codexloop](https://github.com/adammatthewsteinberger/codexloop)** · **[cursorloop](https://github.com/adammatthewsteinberger/cursorloop)** · **[agyloop](https://github.com/adammatthewsteinberger/agyloop)** — autonomous coding-session runners with the same contract, different vendor
- **[vibey](https://github.com/adammatthewsteinberger/vibey)** — six-phase queue conductor over the loop runners
- **[vibey-bootstrap](https://github.com/adammatthewsteinberger/vibey-bootstrap)** — the Azure Functions cross-cutting layer the `vibey-bootstrap` plugin documents (formerly `azure-bootstrap`)
- **[homebrew-tap](https://github.com/adammatthewsteinberger/homebrew-tap)** — `brew tap adammatthewsteinberger/tap`
- **[clippy-pet](https://github.com/adammatthewsteinberger/clippy-pet)** — the fun one

## Contributing

Nearly every contribution is Markdown (skill content) or JSON (manifests). To add or
change a plugin: edit under `plugins/<name>/`, bump `version` in its `plugin.json`,
mirror `version` / `description` / `category` into `marketplace.json`, update the table
above if the skill count or summary changed, then:

```bash
python3 tools/validate_manifests.py
python3 tools/check_links.py
pip install -e ".[docs]" && mkdocs build --strict
```

Branch from `develop`; PRs need green CI. Full workflow and the `SKILL.md` format:
[CONTRIBUTING.md](https://github.com/adammatthewsteinberger/vibey-skills/blob/main/CONTRIBUTING.md)
and [CLAUDE.md](https://github.com/adammatthewsteinberger/vibey-skills/blob/main/CLAUDE.md).

## License & attribution

[MIT](https://github.com/adammatthewsteinberger/vibey-skills/blob/main/LICENSE) © 2026 The Vizius Group and Adam Matthew Steinberger.
Contributions are accepted under the same license.

vibey-skills was originally developed as `TheViziusGroup/vibe-engineering-skills` by Adam
Matthew Steinberger while at The Vizius Group, and is republished here with the permission of
The Vizius Group — see [NOTICE.md](https://github.com/adammatthewsteinberger/vibey-skills/blob/main/NOTICE.md).

---

Built by [Adam Matthew Steinberger](https://hire.adam.matthewsteinberger.com) · [more open source](https://hire.adam.matthewsteinberger.com/open-source)
