Metadata-Version: 2.4
Name: agent-skills-playbook
Version: 0.1.0
Summary: Validate and render portable AI agent skills.
Author-email: Mukunda Katta <mukunda.vjcs6@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://gitlab.com/mukunda.vjcs6-group/agent-skills-playbook
Project-URL: Repository, https://gitlab.com/mukunda.vjcs6-group/agent-skills-playbook
Project-URL: Issues, https://gitlab.com/mukunda.vjcs6-group/agent-skills-playbook/-/issues
Keywords: ai-agents,skills,prompts,coding-agents
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# agent-skills-playbook

Production-grade AI agent skills, prompts, and operating playbooks.

This repo is inspired by the late-April 2026 wave around agent skill libraries and coding-agent behavior packs, including GitTrend's April 24 ranking for `forrestchang/andrej-karpathy-skills`, `google/skills`, and `addyosmani/agent-skills`.

## Goal

Build a practical catalog of small, reusable agent skills that make coding agents more reliable in real work: research, planning, implementation, review, release notes, documentation, and incident debugging.

## First Skills

- `research-first-dev`: gather sources and repo context before implementation.
- `code-review-hawk`: review changes with line-level findings and risk ranking.
- `ship-ready-readme`: turn rough project notes into a usable README.
- `agent-memory-brief`: create compact handoff notes for long-running agent tasks.
- `security-pass`: scan a repo for obvious secret, dependency, and permission risks.

## Repository Shape

```text
skills/
  research-first-dev/
    SKILL.md
  code-review-hawk/
    SKILL.md
templates/
  handoff.md
  release-notes.md
examples/
  sample-agent-run.md
```

## Milestone 1

- Done: define the `SKILL.md` template.
- Done: add five starter skills.
- Done: include a validation CLI.
- Next: add before/after examples for each skill.

## Run It

```bash
python -m agent_skills_playbook.cli list
python -m agent_skills_playbook.cli validate
python -m agent_skills_playbook.cli render-index
```

## Test It

```bash
PYTHONPATH=src python -m pytest
```

## Publish

This package is ready for GitLab Package Registry and PyPI releases. See [RELEASE.md](RELEASE.md).

## Trend Notes

- Agent skills are getting shared as portable behavior modules.
- The viral repos are simple, text-first, and easy to fork.
- The opportunity here is quality control: testable, versioned skills instead of random prompt snippets.
