abvx-agent-skills 0.8.0__tar.gz

abvx_agent_skills-0.8.0/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/

abvx_agent_skills-0.8.0/ATTRIBUTION.md

@@ -0,0 +1,30 @@
+# Attribution
+
+ABVX Agent Skills are original or adapted workflow artifacts informed by public agent-skill and trustworthy-AI work.
+
+## Sources And Inspiration
+
+- Agent Skills specification: portable `SKILL.md` directory format, progressive disclosure, metadata-first discovery. https://agentskills.io/
+- NVIDIA Trustworthy-AI Skill Card: risk, intended-use, evaluation, and ethical-consideration card structure. https://github.com/NVIDIA/Trustworthy-AI/blob/main/Skill%20Card.md
+- Microsoft SkillOpt: validation-gated skill evolution, accepted/rejected edit discipline, reusable skill improvement loop. https://github.com/microsoft/SkillOpt
+- DannyMac180 `codex-dynamic-workflows`: supervised workflow packets, integration, verification, and risk gates for multi-agent work. https://github.com/DannyMac180/skills
+- CodexSaver by fendouai: bounded delegation, risk routing, sandbox-first patches, and read-only specialist patterns. https://github.com/fendouai/CodexSaver
+- context-dot-dev `designmd-supply`: `DESIGN.md` as a machine-readable brand/design-system artifact for agents. https://github.com/context-dot-dev/designmd-supply
+- virgiliojr94 `book-to-skill`: converting long-form documents into progressive-disclosure skills. https://github.com/virgiliojr94/book-to-skill
+- s3rgeym `hh-applicant-tool`: dry-run, scoring, skip-reason, and local-history ideas for job-search workflows. https://github.com/s3rgeym/hh-applicant-tool
+- JuliusBrussee `caveman`: aggressive output-token compression modes and terse answer patterns. https://github.com/juliusbrussee/caveman
+- drona23 `claude-token-efficient`: practical execution rules for reducing repeated reads, rewrites, and filler. https://github.com/drona23/claude-token-efficient
+- nadimtuhin `claude-token-optimizer`: startup-context minimization via small always-loaded core files and on-demand documentation. https://github.com/nadimtuhin/claude-token-optimizer
+- Mibayy `token-savior`: Bash output compaction, persistent memory, and reduced tool-surface ideas for token-efficient coding-agent loops. https://github.com/Mibayy/token-savior
+- tirth8205 `code-review-graph`: graph-guided code reading, targeted review context, and blast-radius-first repo navigation. https://github.com/tirth8205/code-review-graph
+- rtk-ai `rtk`: shell-command rewriting and compact output filtering for high-noise developer commands. https://github.com/rtk-ai/rtk
+- alexgreensh `token-optimizer`: token-waste categorization, compaction survival, and measurement-driven optimization loops. https://github.com/alexgreensh/token-optimizer
+- withkynam `vibecode-pro-max-kit`: approval-gated project setup, context generation, and durable context-maintenance patterns for long-running agent work. https://github.com/withkynam/vibecode-pro-max-kit
+- robzilla1738 `supergoal`: preflight gating, phase-spec execution, baseline-vs-working-tree audit, and bounded three-strike recovery patterns for long autonomous delivery loops. https://github.com/robzilla1738/supergoal
+- Matt Pocock `skills`: small, composable engineering workflows for grilling, TDD, issue slicing, triage, and zoom-out reasoning. https://github.com/mattpocock/skills
+- Local ABVX workflow skills: diagnosis, handoff, complexity optimization, frontend product building, architecture deepening review, browser verification, agent harness design, prototyping, and web quality audit patterns.
+- Modern web platform guidance: accessibility, performance, user experience, privacy, and browser-security patterns were condensed into the `web-quality-audit` skill.
+
+## Notes
+
+This repository does not claim endorsement by the projects above. Where ideas are adapted, the ABVX versions are rewritten for Codex-style project work, local validation, and conservative approval gates.

abvx_agent_skills-0.8.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anton Biletskiy-Volokh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

abvx_agent_skills-0.8.0/PKG-INFO

@@ -0,0 +1,238 @@
+Metadata-Version: 2.4
+Name: abvx-agent-skills
+Version: 0.8.0
+Summary: Small, reviewable, validation-gated agent skills for Codex-style project work.
+Project-URL: Homepage, https://github.com/markoblogo/abvx-agent-skills
+Project-URL: Repository, https://github.com/markoblogo/abvx-agent-skills
+Project-URL: Issues, https://github.com/markoblogo/abvx-agent-skills/issues
+Author: markoblogo
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,codex,llm,prompts,skills
+Classifier: License :: OSI Approved :: MIT License
+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 :: Software Development
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.10
+Requires-Dist: pyyaml>=6.0
+Description-Content-Type: text/markdown
+
+# ABVX Agent Skills
+
+<p>
+  <img src="assets/skillslogo.png" alt="ABVX Agent Skills logo" width="1536" height="1024">
+</p>
+
+Small, reviewable, validation-gated agent skills for Codex-style project work.
+
+This repository publishes opinionated ABVX skillpacks: compact `SKILL.md` workflows with clear triggers, attribution, risk notes, and validation. These are not prompt dumps. They are portable, versioned agent capabilities meant to be loaded on demand through the Agent Skills progressive-disclosure model.
+
+## Start Here
+
+- **Need to save tokens?** Start with `rtk-assisted-shell`, `shell-output-compaction`, `token-efficient-execution`, and `lean-context-layout`. Add `compaction-survival` if your sessions run long enough to forget their own state.
+- **Need to debug a repo?** Start with `diagnose`, `repo-debugging-ledger`, and `graph-guided-code-reading`.
+- **Need to build frontend?** Start with `frontend-product-builder`, `designmd-brand-kit`, and `browser-verification`.
+- **Need long-session continuity?** Start with `handoff`, `compaction-survival`, and `token-usage-audit`.
+- **Need to onboard a new repo?** Start with `project-context-bootstrap` and follow with `durable-context-maintenance`.
+- **Need discovery or product shaping?** Start with `rapid-grilling`, `doc-grounded-grilling`, and `spec-to-prd`.
+- **Need to turn plans into execution?** Start with `plan-to-issues`, `repo-issue-triage`, and `test-driven-execution`.
+- **Need safer long delivery runs?** Start with `delivery-preflight-gate`, `phase-spec-execution`, `recovery-loop-3strike`, and `delivery-baseline-audit`.
+- **Need a full multi-track workflow?** Start with `dynamic-workflow-packets`.
+- **Need to build reusable assistant packs?** Start with `role-skill-pack-design`, `workflow-policy-layering`, `brief-first-execution`, and `private-vs-publishable-skill-audit`.
+
+## Skills
+
+These skills are grouped by the job they do. The token-economy layer is intentionally visible first: for many teams, the easiest win is not “a smarter prompt”, but less wasted context.
+
+### Token Economy & Context Control
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `rtk-assisted-shell` | Routes noisy shell workflows through RTK-style filtering. On shell-heavy tasks this can cut command-output tokens dramatically, often in the same range as RTK's reported 60-90% savings on common dev commands. | experimental | ABVX adapted |
+| `shell-output-compaction` | Shrinks logs, diffs, and repo search output into counts, slices, and error-first excerpts. Usually the fastest way to turn multi-screen stdout into a small, usable artifact. | experimental | ABVX adapted |
+| `graph-guided-code-reading` | Replaces broad repo reading with entrypoints, symbols, dependencies, and blast radius. On large codebases this can turn “read everything” into a much smaller focus set. | experimental | ABVX adapted |
+| `token-efficient-execution` | Cuts waste from repeated reads, broad rewrites, and low-value narration. Best for long coding sessions where the loop, not the final answer, is burning the budget. | experimental | ABVX adapted |
+| `token-frugal-mode` | Compresses final answers without dropping the decisive technical signal. Useful when the session is tight and you want shorter replies without caveman-style degradation. | experimental | ABVX adapted |
+| `lean-context-layout` | Shrinks always-loaded agent docs into a compact startup core and pushes the rest on demand. Best for bloated `AGENTS.md`, `CLAUDE.md`, and repo runbooks. | experimental | ABVX adapted |
+| `compaction-survival` | Preserves the high-value working state before long sessions collapse into compaction. Saves the turns you would otherwise spend reconstructing “what were we doing?”. | experimental | ABVX adapted |
+| `token-usage-audit` | Diagnoses where the budget is really going: startup bloat, shell noise, repeated reads, oversized summaries, or compaction loss. Use this before over-optimizing the wrong layer. | experimental | ABVX adapted |
+
+### Coding, Debugging & Architecture
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `diagnose` | Runs a disciplined debugging loop around one reproducible signal, ranked hypotheses, and narrow verification. | experimental | ABVX adapted |
+| `repo-debugging-ledger` | Keeps a checked-location ledger so debugging does not keep reopening the same code and repeating the same dead ends. | experimental | ABVX original |
+| `complexity-optimizer` | Finds safe complexity and performance simplifications without turning the codebase into a refactor festival. | experimental | ABVX adapted |
+| `architecture-deepening-review` | Reviews deeper module seams, coupling, change surfaces, and testability, not just top-level architecture slogans. | experimental | ABVX adapted |
+| `test-driven-execution` | Builds features and fixes through one-behavior-at-a-time red-green-refactor loops instead of broad speculative implementation. | experimental | ABVX adapted |
+| `system-zoom-out` | Pulls a local code area back into its wider system map so you can reason about callers, modules, boundaries, and blast radius. | experimental | ABVX adapted |
+| `agents-best-practices` | Hardens agent harnesses around permissions, context shape, safety, and evaluation discipline. | experimental | ABVX adapted |
+| `skillopt-evolve-skills` | Improves agent instructions and skills from real task evidence rather than from theory alone. | experimental | ABVX adapted |
+
+### Frontend, UX & Product Surfaces
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `frontend-product-builder` | Builds usable frontends, landing pages, pitch pages, dashboards, and prototypes with a product-first interaction model. | experimental | ABVX adapted |
+| `designmd-brand-kit` | Turns a website or brand surface into an agent-usable design system: structure, identity, and reusable UI cues. | experimental | ABVX adapted |
+| `browser-verification` | Verifies real browser rendering, responsive layout, and interaction behavior instead of trusting static code inspection. | experimental | ABVX adapted |
+| `web-quality-audit` | Audits accessibility, performance, UX, privacy, and browser security as one practical web quality pass. | experimental | ABVX adapted |
+| `prototype-lab` | Rapid throwaway builds for testing interaction, logic, and product direction before committing to heavier implementation. | experimental | ABVX adapted |
+
+### Project Context & Onboarding
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `project-context-bootstrap` | Detects the stack, asks the right project questions, and turns a weakly documented repo into a compact, agent-usable context surface. | experimental | ABVX adapted |
+| `durable-context-maintenance` | Keeps repo-local context current after architecture, workflow, and test-flow changes so agents stop rediscovering the same facts. | experimental | ABVX adapted |
+
+### Discovery, Planning & Delivery
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `rapid-grilling` | Quickly sharpens vague ideas through one-question-at-a-time alignment before heavier planning starts. | experimental | ABVX adapted |
+| `doc-grounded-grilling` | Stress-tests a plan against repo docs, ADRs, design assets, and domain language so discovery stays grounded in reality. | experimental | ABVX adapted |
+| `spec-to-prd` | Turns clarified context into a durable PRD for product, client, and internal roadmap work. | experimental | ABVX adapted |
+| `plan-to-issues` | Breaks PRDs and plans into thin end-to-end slices that agents or humans can actually pick up. | experimental | ABVX adapted |
+| `repo-issue-triage` | Moves bugs and enhancements through a compact state machine so backlog items become actionable instead of vague. | experimental | ABVX adapted |
+
+### Research, Knowledge & Reusable Methods
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `evidence-ledger-research` | Keeps claims, sources, calculations, and open questions in a disciplined evidence ledger. | experimental | ABVX original |
+| `book-to-skill` | Converts books, papers, and long documents into reusable, progressive-disclosure agent skills. | experimental | ABVX adapted |
+| `role-skill-pack-design` | Designs compact role/workflow skill packs with base layers, difference layers, boundaries, and rollout order. | experimental | ABVX original |
+| `workflow-policy-layering` | Separates workflow from authority, escalation, forbidden actions, and validation so assistant specs stop contradicting themselves. | experimental | ABVX original |
+| `brief-first-execution` | Starts non-trivial work with one live brief for scope, non-goals, risks, verification, and done criteria. | experimental | ABVX original |
+| `private-vs-publishable-skill-audit` | Audits private skill packs before publication and extracts only the reusable layer. | experimental | ABVX original |
+
+### Workflow, Handoffs & Multi-Track Work
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `dynamic-workflow-packets` | Orchestrates large coding, research, audit, or client-search tracks without losing verification and risk gates. | experimental | ABVX adapted |
+| `handoff` | Produces compact continuation briefs for long-running work, agent resumes, and human handoffs. | experimental | ABVX adapted |
+
+### Long-Run Delivery Control
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `delivery-preflight-gate` | Runs the minimum useful baseline checks before a long implementation loop starts, so pre-existing breakage does not poison later verification. | experimental | ABVX adapted |
+| `phase-spec-execution` | Breaks larger delivery into explicit phases with acceptance criteria, verification commands, and lightweight state updates. | experimental | ABVX adapted |
+| `recovery-loop-3strike` | Bounds execution failure handling to one evidence-bearing retry, one focused fix-spec, and then an honest blocker handoff. | experimental | ABVX adapted |
+| `delivery-baseline-audit` | Re-checks declared deliverables and final verification against the starting baseline and full working tree before calling the task complete. | experimental | ABVX adapted |
+
+### Structured Data & Spreadsheet Work
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `spreadsheet-workbook-forensics` | Repairs and edits spreadsheets where workbook structure, formulas, and cell-level verification matter. | experimental | ABVX original |
+
+## Install
+
+Install one skill into Codex:
+
+```bash
+git clone https://github.com/markoblogo/abvx-agent-skills
+cp -R abvx-agent-skills/skills/dynamic-workflow-packets ~/.codex/skills/
+```
+
+Install all skills:
+
+```bash
+git clone https://github.com/markoblogo/abvx-agent-skills
+cp -R abvx-agent-skills/skills/* ~/.codex/skills/
+```
+
+Start a new agent session after installation so the skill descriptions are discovered.
+
+Install via PyPI:
+
+```bash
+pip install abvx-agent-skills
+abvx-skills list
+abvx-skills install
+```
+
+Install one packaged skill into Codex:
+
+```bash
+abvx-skills install dynamic-workflow-packets
+```
+
+Install to a custom destination:
+
+```bash
+abvx-skills install --destination ./tmp-skills
+```
+
+## Repository Profile
+
+Each public skill includes:
+
+- `SKILL.md` - executable agent instructions
+- `SKILL_CARD.md` - intended use, attribution, risks, evaluation, and version
+- `agents/openai.yaml` - Codex UI metadata
+
+The project follows the open Agent Skills shape: `SKILL.md` plus optional `scripts/`, `references/`, and `assets/`. For Codex compatibility, top-level frontmatter is kept conservative: `name`, `description`, `license`, `metadata`, and supported fields only.
+
+## Validate
+
+```bash
+python scripts/validate.py
+```
+
+Or validate the packaged skills through the CLI:
+
+```bash
+abvx-skills validate
+```
+
+Validate a local skills directory:
+
+```bash
+abvx-skills validate ~/.codex/skills
+```
+
+The validator checks required files, frontmatter, directory/name alignment, TODO placeholders, cards, UI metadata, and basic secret patterns.
+
+## Release
+
+Build and check the package locally:
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+Publish flow:
+
+- Run the `publish` GitHub Actions workflow with `repository=testpypi` for a dry run against TestPyPI.
+- Create a GitHub release, or run the same workflow with `repository=pypi`, to publish to PyPI.
+- Configure trusted publishing for both `pypi` and `testpypi` environments in the package index before the first release.
+
+## Philosophy
+
+- Keep always-loaded context small.
+- Prefer procedural rules over vague advice.
+- Make skills easy to audit in diffs.
+- Attribute upstream inspiration.
+- Pair useful automation with risk gates and verification.
+
+See [docs/abvx-skillpack-profile.md](docs/abvx-skillpack-profile.md) for the repository standard.
+
+## Attribution
+
+Several skills are inspired by public work from the broader agent tooling ecosystem. See [ATTRIBUTION.md](ATTRIBUTION.md).
+
+## License
+
+MIT. See [LICENSE](LICENSE).

abvx_agent_skills-0.8.0/README.md

@@ -0,0 +1,214 @@
+# ABVX Agent Skills
+
+<p>
+  <img src="assets/skillslogo.png" alt="ABVX Agent Skills logo" width="1536" height="1024">
+</p>
+
+Small, reviewable, validation-gated agent skills for Codex-style project work.
+
+This repository publishes opinionated ABVX skillpacks: compact `SKILL.md` workflows with clear triggers, attribution, risk notes, and validation. These are not prompt dumps. They are portable, versioned agent capabilities meant to be loaded on demand through the Agent Skills progressive-disclosure model.
+
+## Start Here
+
+- **Need to save tokens?** Start with `rtk-assisted-shell`, `shell-output-compaction`, `token-efficient-execution`, and `lean-context-layout`. Add `compaction-survival` if your sessions run long enough to forget their own state.
+- **Need to debug a repo?** Start with `diagnose`, `repo-debugging-ledger`, and `graph-guided-code-reading`.
+- **Need to build frontend?** Start with `frontend-product-builder`, `designmd-brand-kit`, and `browser-verification`.
+- **Need long-session continuity?** Start with `handoff`, `compaction-survival`, and `token-usage-audit`.
+- **Need to onboard a new repo?** Start with `project-context-bootstrap` and follow with `durable-context-maintenance`.
+- **Need discovery or product shaping?** Start with `rapid-grilling`, `doc-grounded-grilling`, and `spec-to-prd`.
+- **Need to turn plans into execution?** Start with `plan-to-issues`, `repo-issue-triage`, and `test-driven-execution`.
+- **Need safer long delivery runs?** Start with `delivery-preflight-gate`, `phase-spec-execution`, `recovery-loop-3strike`, and `delivery-baseline-audit`.
+- **Need a full multi-track workflow?** Start with `dynamic-workflow-packets`.
+- **Need to build reusable assistant packs?** Start with `role-skill-pack-design`, `workflow-policy-layering`, `brief-first-execution`, and `private-vs-publishable-skill-audit`.
+
+## Skills
+
+These skills are grouped by the job they do. The token-economy layer is intentionally visible first: for many teams, the easiest win is not “a smarter prompt”, but less wasted context.
+
+### Token Economy & Context Control
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `rtk-assisted-shell` | Routes noisy shell workflows through RTK-style filtering. On shell-heavy tasks this can cut command-output tokens dramatically, often in the same range as RTK's reported 60-90% savings on common dev commands. | experimental | ABVX adapted |
+| `shell-output-compaction` | Shrinks logs, diffs, and repo search output into counts, slices, and error-first excerpts. Usually the fastest way to turn multi-screen stdout into a small, usable artifact. | experimental | ABVX adapted |
+| `graph-guided-code-reading` | Replaces broad repo reading with entrypoints, symbols, dependencies, and blast radius. On large codebases this can turn “read everything” into a much smaller focus set. | experimental | ABVX adapted |
+| `token-efficient-execution` | Cuts waste from repeated reads, broad rewrites, and low-value narration. Best for long coding sessions where the loop, not the final answer, is burning the budget. | experimental | ABVX adapted |
+| `token-frugal-mode` | Compresses final answers without dropping the decisive technical signal. Useful when the session is tight and you want shorter replies without caveman-style degradation. | experimental | ABVX adapted |
+| `lean-context-layout` | Shrinks always-loaded agent docs into a compact startup core and pushes the rest on demand. Best for bloated `AGENTS.md`, `CLAUDE.md`, and repo runbooks. | experimental | ABVX adapted |
+| `compaction-survival` | Preserves the high-value working state before long sessions collapse into compaction. Saves the turns you would otherwise spend reconstructing “what were we doing?”. | experimental | ABVX adapted |
+| `token-usage-audit` | Diagnoses where the budget is really going: startup bloat, shell noise, repeated reads, oversized summaries, or compaction loss. Use this before over-optimizing the wrong layer. | experimental | ABVX adapted |
+
+### Coding, Debugging & Architecture
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `diagnose` | Runs a disciplined debugging loop around one reproducible signal, ranked hypotheses, and narrow verification. | experimental | ABVX adapted |
+| `repo-debugging-ledger` | Keeps a checked-location ledger so debugging does not keep reopening the same code and repeating the same dead ends. | experimental | ABVX original |
+| `complexity-optimizer` | Finds safe complexity and performance simplifications without turning the codebase into a refactor festival. | experimental | ABVX adapted |
+| `architecture-deepening-review` | Reviews deeper module seams, coupling, change surfaces, and testability, not just top-level architecture slogans. | experimental | ABVX adapted |
+| `test-driven-execution` | Builds features and fixes through one-behavior-at-a-time red-green-refactor loops instead of broad speculative implementation. | experimental | ABVX adapted |
+| `system-zoom-out` | Pulls a local code area back into its wider system map so you can reason about callers, modules, boundaries, and blast radius. | experimental | ABVX adapted |
+| `agents-best-practices` | Hardens agent harnesses around permissions, context shape, safety, and evaluation discipline. | experimental | ABVX adapted |
+| `skillopt-evolve-skills` | Improves agent instructions and skills from real task evidence rather than from theory alone. | experimental | ABVX adapted |
+
+### Frontend, UX & Product Surfaces
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `frontend-product-builder` | Builds usable frontends, landing pages, pitch pages, dashboards, and prototypes with a product-first interaction model. | experimental | ABVX adapted |
+| `designmd-brand-kit` | Turns a website or brand surface into an agent-usable design system: structure, identity, and reusable UI cues. | experimental | ABVX adapted |
+| `browser-verification` | Verifies real browser rendering, responsive layout, and interaction behavior instead of trusting static code inspection. | experimental | ABVX adapted |
+| `web-quality-audit` | Audits accessibility, performance, UX, privacy, and browser security as one practical web quality pass. | experimental | ABVX adapted |
+| `prototype-lab` | Rapid throwaway builds for testing interaction, logic, and product direction before committing to heavier implementation. | experimental | ABVX adapted |
+
+### Project Context & Onboarding
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `project-context-bootstrap` | Detects the stack, asks the right project questions, and turns a weakly documented repo into a compact, agent-usable context surface. | experimental | ABVX adapted |
+| `durable-context-maintenance` | Keeps repo-local context current after architecture, workflow, and test-flow changes so agents stop rediscovering the same facts. | experimental | ABVX adapted |
+
+### Discovery, Planning & Delivery
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `rapid-grilling` | Quickly sharpens vague ideas through one-question-at-a-time alignment before heavier planning starts. | experimental | ABVX adapted |
+| `doc-grounded-grilling` | Stress-tests a plan against repo docs, ADRs, design assets, and domain language so discovery stays grounded in reality. | experimental | ABVX adapted |
+| `spec-to-prd` | Turns clarified context into a durable PRD for product, client, and internal roadmap work. | experimental | ABVX adapted |
+| `plan-to-issues` | Breaks PRDs and plans into thin end-to-end slices that agents or humans can actually pick up. | experimental | ABVX adapted |
+| `repo-issue-triage` | Moves bugs and enhancements through a compact state machine so backlog items become actionable instead of vague. | experimental | ABVX adapted |
+
+### Research, Knowledge & Reusable Methods
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `evidence-ledger-research` | Keeps claims, sources, calculations, and open questions in a disciplined evidence ledger. | experimental | ABVX original |
+| `book-to-skill` | Converts books, papers, and long documents into reusable, progressive-disclosure agent skills. | experimental | ABVX adapted |
+| `role-skill-pack-design` | Designs compact role/workflow skill packs with base layers, difference layers, boundaries, and rollout order. | experimental | ABVX original |
+| `workflow-policy-layering` | Separates workflow from authority, escalation, forbidden actions, and validation so assistant specs stop contradicting themselves. | experimental | ABVX original |
+| `brief-first-execution` | Starts non-trivial work with one live brief for scope, non-goals, risks, verification, and done criteria. | experimental | ABVX original |
+| `private-vs-publishable-skill-audit` | Audits private skill packs before publication and extracts only the reusable layer. | experimental | ABVX original |
+
+### Workflow, Handoffs & Multi-Track Work
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `dynamic-workflow-packets` | Orchestrates large coding, research, audit, or client-search tracks without losing verification and risk gates. | experimental | ABVX adapted |
+| `handoff` | Produces compact continuation briefs for long-running work, agent resumes, and human handoffs. | experimental | ABVX adapted |
+
+### Long-Run Delivery Control
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `delivery-preflight-gate` | Runs the minimum useful baseline checks before a long implementation loop starts, so pre-existing breakage does not poison later verification. | experimental | ABVX adapted |
+| `phase-spec-execution` | Breaks larger delivery into explicit phases with acceptance criteria, verification commands, and lightweight state updates. | experimental | ABVX adapted |
+| `recovery-loop-3strike` | Bounds execution failure handling to one evidence-bearing retry, one focused fix-spec, and then an honest blocker handoff. | experimental | ABVX adapted |
+| `delivery-baseline-audit` | Re-checks declared deliverables and final verification against the starting baseline and full working tree before calling the task complete. | experimental | ABVX adapted |
+
+### Structured Data & Spreadsheet Work
+
+| Skill | What It Does | Status | Origin |
+|---|---|---|---|
+| `spreadsheet-workbook-forensics` | Repairs and edits spreadsheets where workbook structure, formulas, and cell-level verification matter. | experimental | ABVX original |
+
+## Install
+
+Install one skill into Codex:
+
+```bash
+git clone https://github.com/markoblogo/abvx-agent-skills
+cp -R abvx-agent-skills/skills/dynamic-workflow-packets ~/.codex/skills/
+```
+
+Install all skills:
+
+```bash
+git clone https://github.com/markoblogo/abvx-agent-skills
+cp -R abvx-agent-skills/skills/* ~/.codex/skills/
+```
+
+Start a new agent session after installation so the skill descriptions are discovered.
+
+Install via PyPI:
+
+```bash
+pip install abvx-agent-skills
+abvx-skills list
+abvx-skills install
+```
+
+Install one packaged skill into Codex:
+
+```bash
+abvx-skills install dynamic-workflow-packets
+```
+
+Install to a custom destination:
+
+```bash
+abvx-skills install --destination ./tmp-skills
+```
+
+## Repository Profile
+
+Each public skill includes:
+
+- `SKILL.md` - executable agent instructions
+- `SKILL_CARD.md` - intended use, attribution, risks, evaluation, and version
+- `agents/openai.yaml` - Codex UI metadata
+
+The project follows the open Agent Skills shape: `SKILL.md` plus optional `scripts/`, `references/`, and `assets/`. For Codex compatibility, top-level frontmatter is kept conservative: `name`, `description`, `license`, `metadata`, and supported fields only.
+
+## Validate
+
+```bash
+python scripts/validate.py
+```
+
+Or validate the packaged skills through the CLI:
+
+```bash
+abvx-skills validate
+```
+
+Validate a local skills directory:
+
+```bash
+abvx-skills validate ~/.codex/skills
+```
+
+The validator checks required files, frontmatter, directory/name alignment, TODO placeholders, cards, UI metadata, and basic secret patterns.
+
+## Release
+
+Build and check the package locally:
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+Publish flow:
+
+- Run the `publish` GitHub Actions workflow with `repository=testpypi` for a dry run against TestPyPI.
+- Create a GitHub release, or run the same workflow with `repository=pypi`, to publish to PyPI.
+- Configure trusted publishing for both `pypi` and `testpypi` environments in the package index before the first release.
+
+## Philosophy
+
+- Keep always-loaded context small.
+- Prefer procedural rules over vague advice.
+- Make skills easy to audit in diffs.
+- Attribute upstream inspiration.
+- Pair useful automation with risk gates and verification.
+
+See [docs/abvx-skillpack-profile.md](docs/abvx-skillpack-profile.md) for the repository standard.
+
+## Attribution
+
+Several skills are inspired by public work from the broader agent tooling ecosystem. See [ATTRIBUTION.md](ATTRIBUTION.md).
+
+## License
+
+MIT. See [LICENSE](LICENSE).

abvx_agent_skills-0.8.0/docs/abvx-skillpack-profile.md

@@ -0,0 +1,63 @@
+# ABVX Skillpack Profile
+
+ABVX skillpacks are small, reviewable agent skills for project work.
+
+## Required Files
+
+Each public skill should include:
+
+```text
+skills/<skill-name>/
+  SKILL.md
+  SKILL_CARD.md
+  agents/openai.yaml
+```
+
+Optional resources:
+
+```text
+scripts/
+references/
+assets/
+```
+
+## Frontmatter
+
+Use conservative frontmatter for Codex compatibility:
+
+```yaml
+---
+name: skill-name
+description: What this skill does and when to use it.
+license: MIT
+metadata:
+  abvx_status: experimental
+  abvx_origin: original
+---
+```
+
+Keep the description trigger-rich and under 1024 characters.
+
+## Skill Card
+
+`SKILL_CARD.md` documents:
+
+- description,
+- owner,
+- license,
+- intended use,
+- out of scope,
+- sources and attribution,
+- inputs and outputs,
+- risks and mitigations,
+- evaluation,
+- version,
+- reporting issues.
+
+## Quality Bar
+
+- Actionable rules beat explanations.
+- Avoid broad process for small tasks.
+- Do not store secrets, bulky logs, personal data, private contacts, or copied book chapters.
+- Add approval gates for destructive, external, expensive, or privacy-sensitive work.
+- Report verification honestly.

abvx_agent_skills-0.8.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["hatchling>=1.25.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "abvx-agent-skills"
+version = "0.8.0"
+description = "Small, reviewable, validation-gated agent skills for Codex-style project work."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+  { name = "markoblogo" }
+]
+dependencies = [
+  "PyYAML>=6.0",
+]
+keywords = ["agents", "skills", "codex", "llm", "prompts"]
+classifiers = [
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development",
+  "Topic :: Text Processing",
+]
+
+[project.urls]
+Homepage = "https://github.com/markoblogo/abvx-agent-skills"
+Repository = "https://github.com/markoblogo/abvx-agent-skills"
+Issues = "https://github.com/markoblogo/abvx-agent-skills/issues"
+
+[project.scripts]
+abvx-skills = "abvx_agent_skills.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/abvx_agent_skills"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"skills" = "src/abvx_agent_skills/skills"
+"docs" = "src/abvx_agent_skills/docs"
+"LICENSE" = "src/abvx_agent_skills/LICENSE"
+"ATTRIBUTION.md" = "src/abvx_agent_skills/ATTRIBUTION.md"
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/src",
+  "/skills",
+  "/docs",
+  "/scripts",
+  "/README.md",
+  "/LICENSE",
+  "/ATTRIBUTION.md",
+]

abvx_agent_skills-0.8.0/scripts/validate.py

@@ -0,0 +1,27 @@
+#!/usr/bin/env python3
+from __future__ import annotations
+
+from pathlib import Path
+import sys
+
+ROOT = Path(__file__).resolve().parents[1]
+SRC = ROOT / "src"
+if str(SRC) not in sys.path:
+    sys.path.insert(0, str(SRC))
+
+from abvx_agent_skills.validator import validate_skills_root
+
+
+def main() -> int:
+    failures = validate_skills_root(ROOT / "skills")
+    if failures:
+        print("Validation failed:")
+        for item in failures:
+            print(f"- {item}")
+        return 1
+    print("All skills valid.")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())