Github actions maintainer

Skill tuanductran/soulmap-ai/.claude/skills/github-actions-maintainer

Review or update GitHub Actions workflows for SoulMap AI, especially CI, release, CodeQL, permissions, concurrency, and actionlint-safe changes that should stay aligned with existing repo tooling.From its SKILL.md

Install

npx -y skills add tuanductran/soulmap-ai --skill github-actions-maintainer

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.4 KB, as published. Nobody here has run it

GitHub Actions maintainer

Use this skill when working on:

files under .github/workflows/
CI failures tied to workflow syntax or job design
GitHub Actions permissions, concurrency, caching, or artifact handling
release automation
CodeQL workflow maintenance

Sources to check first

../rules/github-actions.md
../rules/repo-workflow.md
../rules/python-tooling.md
.github/workflows/
src/soulmap/devtools/
docs/engineering/DEV.md
docs/operations/OPERATIONS.md

Do not use this skill for

application Python changes that do not affect CI or release automation
SoulMap product behavior, voice, brand, or safety content
release-readiness review without any workflow editing
generic repository planning when no GitHub Actions surface is involved

What good looks like

smallest correct workflow diff
least-privilege permissions
stable triggers
clear concurrency behavior
reuse of existing repo commands
local validation that mirrors CI

Workflow

Read the target workflow and the adjacent workflows first.
Identify whether the change affects triggers, permissions, concurrency, caching, artifacts, or release semantics.
Reuse existing repository commands rather than duplicating logic in shell.
Keep official GitHub actions aligned with current repo conventions.
Explain any new third-party action or permission increase explicitly.
Run the matching local validation commands after the edit.

Validation

Always run:

uv run soulmap format
uv run soulmap lint
uv run soulmap test -n auto -q

Add these when relevant:

uv run soulmap eval-groups
uv run soulmap markdown-contract --root .
uv run soulmap build
uv run soulmap build --skill

If actionlint is available, run it after changing workflow files.

Definition of done

The workflow update is done when:

the diff is limited to the GitHub Actions surface that actually changed
triggers, permissions, and concurrency behavior are explicit
existing repository commands are reused instead of duplicated
any new third-party action or permission increase is justified
the relevant local checks pass