aap-snapshot-collection-authoring

Conventions for contributing to the ansible.aap_snapshot collection. Use when writing changelog fragments, following coding standards, or preparing contributions to the aap-snapshot-collection repository.

Jump to install

Repository: ansible-collections/aap-snapshot-collection
Last source activity: July 30, 2026 at 10:54
Detected SKILL.md language: English
Stars: 7
Forks: 9

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/ansible-collections/aap-snapshot-collection --skill aap-snapshot-collection-authoring

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

aap-ansible-conventions

Ansible coding style conventions, secret-handling rules, and the custom ansible-lint rules enforced in the aap-snapshot-collection. Use this skill whenever writing or reviewing Ansible tasks, defaults, or templates in this repository — especially anything touching `no_log`, `become`, boolean `when:` conditions, FQCN module names, YAML document markers, or database credentials. Also consult this when fixing a lint error, adding a new task file, touching any `.yml` file in `roles/` or `playbooks/`, or reviewing a diff that registers command/module output that might contain a secret. Even quick one-line fixes should follow these conventions — several were added specifically because a small change missed one of these rules.

2026-08-14

aap-snapshot-collection-review

Code review guide for aap-snapshot-collection pull requests. Use this skill whenever reviewing a PR, doing a code review, checking a diff, or preparing review comments for this repository. Covers the standard review format, severity classification, and area-specific checklists for role structure, security/secrets, database (PostgreSQL) patterns, playbook integration, documentation, and migration safety (export/import correctness). Also use when asked to "review this", "check this PR", "what's wrong with this diff", or when preparing feedback on someone's changes to roles/, playbooks/, or plugins/ in this collection.

2026-08-14

aap-snapshot-collection-structure

Standard role/playbook layout, task-file patterns, plugin conventions, and the export/import/verify orchestration flow for the aap-snapshot-collection (ansible.aap_snapshot). Use this skill whenever creating a new component role, adding task files to an existing role, working with the `operations` or `ocp_utils` engine roles, modifying playbook orchestration (artifact_export.yaml/artifact_import.yaml/artifact_verify.yaml), or trying to understand how a component's export/import/reconcile flow is wired together. Also consult this when adding a new AAP component to the collection, debugging why one component's flow doesn't match the others, or working with the artifact tarball lifecycle (init/build/package/extract/ consume/verify in roles/artifact). Even for small changes like adding a single task file, check that you're following these structural patterns — and note that docs/architecture.md describes role names that no longer exist in the codebase, so treat this skill (and the real roles/ tree) as the source

2026-08-14

View all from this repository

name	aap-snapshot-collection-authoring
description	Conventions for contributing to the ansible.aap_snapshot collection. Use when writing changelog fragments, following coding standards, or preparing contributions to the aap-snapshot-collection repository.