publish-github-skills-exercise

name	publish-github-skills-exercise
description	Prepare a GitHub Skills exercise for publication, contribution, or rollout. Use this when the user asks for release readiness, final checklist, README/marketplace copy, PR description, validation evidence, launch notes, or publishing guidance for a GitHub Skills-style exercise.

Publish GitHub Skills exercise

Use this skill for final release preparation after an exercise has been built and reviewed.

Publication workflow

1. Confirm the repository communicates the exercise clearly.
2. Confirm the learner flow has been validated from a fresh start.
3. Confirm workflow permissions, triggers, and reset behavior are safe.
4. Confirm exercise workflows are disabled by default so nothing runs until the learner starts.
5. Confirm all images, links, snippets, and badges render correctly.
6. Prepare release or contribution copy.
7. Identify any remaining risks and the owner of each follow-up.

If publishing a repository is requested

Apply this safety sequence:

1. Confirm target owner/repository and whether a remote already exists.
2. Disable Actions before first push to avoid accidental workflow execution.
3. Apply repository settings (template flag, description, visibility) as requested.
4. Push repository content.
5. Re-enable Actions for the repository, then verify workflow behavior: only the start (step 0) workflow can run initially; later step workflows stay disabled by default until the previous step enables them.
6. Verify copy/start links reference the new template owner.

If permissions block any step, report the exact failing command and shortest manual recovery path.

Release-readiness checklist

• README includes title, summary, learner audience, prerequisites, duration, start path, and support path.
• Exercise steps match the stated objectives.
• Workflows use least-privilege permissions and have clear trigger behavior.
• Exercise workflows are disabled by default and only run as the learner progresses through the exercise.
• Validation evidence is available: tests, dry run, or documented manual checks.
• Reset/retry behavior is documented and safe for repeated learners.
• No source content contains repository-specific absolute URLs unless required.
• Exercise images are stored in .github/images and referenced with relative paths.
• [!NOTE], [!IMPORTANT], and [!TIP] callouts are left-justified (no indentation).
• License, attribution, and contribution notes are present where needed.

Expected callout formatting:

[!NOTE] This is a note

[!IMPORTANT] This is an important item to be aware of for this exercise

[!TIP] It is a good idea and recommended to do this tip

Output template

## Publish recommendation

## Release summary

## Validation evidence

## Final checklist

## Suggested PR description

## Suggested release notes

## Remaining risks

Be direct if the exercise is not publishable yet. Include the shortest concrete path to readiness.