maintain-simple_gh_aws_creds-base
Maintenance knowledge of the simple_gh_aws_creds library: its architecture (SetupGitHubRepo steps, the python-fire CLI, config loading), the invariants every change must keep, design decisions and the
SKILL.md.claude/skills/maintain-simple_gh_aws_creds-base/SKILL.md
GitHubsimple_gh_aws_creds gives a GitHub repository its own IAM user and stores the user's access key as GitHub Actions secrets. All AWS (boto3 IAM) and GitHub (PyGithub) work is in SetupGitHubRepo in simple_gh_aws_creds/impl.py, as numbered step methods (s1x set up, s2x tear down, s3x maintain). The simple-gh-aws-creds command (cli.py, python-fire) is a thin layer: cli_config.build_setup() turns a JSON config file, an optional AWS profile, and a GitHub token read from a named environment variable into a SetupGitHubRepo, and each of the four commands calls one method on it.
For template conventions (layout, tests, docs, release), load pywf-oss-base.
References
Each cites only earlier ones.
<!-- BEGIN references index: generated by scripts/update_skill_index.py, do not edit by hand -->- Architecture (
references/01-architecture.md): Read before changing any module, to know where a change belongs. - Invariants (
references/02-invariants.md): Read before changing a step method or a CLI command. - Design Decisions (
references/03-design-decisions.md): Read before proposing to change one of these choices. - Unit Tests (
references/04-unit-tests.md): Read when writing or changing a test of impl.py or cli_config.py. - Known Traps (
references/05-known-traps.md): Read when a change touches key files, GitHub secret names, PyGithub calls, CLI arguments, or the docs home page. - Integration Test (
references/06-integration-test.md): Read before running the CLI against real AWS or GitHub, or when changing the config or workflow it uses.
Which skill to use
| Job | Skill | Reads from this base |
|---|---|---|
| Run the integration test against the real AWS account and this GitHub repository, before each release | maintain-simple_gh_aws_creds-run-integration-test |
05-known-traps.md, 06-integration-test.md |
| Any other change to this repo | this base, then the pywf-oss-* skill for the job |
the reference that covers the code being changed |