Working on this skills library

Scope

This repository owns these six skills: h3-prompt-writing, kling-4-prompting, minimax-music-30, seedance-25, suno-song-builder, and threejs-rendering. Preserve their complete reference, script, template, and agent-metadata folders. Do not publish unrelated installed skills or private creative assets.

Local edits and GitHub updates

The owner's requested workflow is to update this repository whenever we update these skills locally. A Git-backed installation uses this checkout directly, while separate local skill directories should be kept in sync when updated.

1. Confirm the checkout and origin are for glitterpixely/skills. Inspect the current branch, working-tree diff, and staged changes before editing. Read CONTRIBUTING.md.
2. Fetch origin. If the working tree is clean and the checked-out branch tracks the intended remote branch, use git pull --ff-only. Preserve existing work; never reset, overwrite, auto-stash, or force-push to resolve divergence. If concurrent edits or conflicts make intent unclear, ask the owner.
3. Edit the relevant skill files in the checkout. If an edit was made in a separate installed copy, compare it with the checkout and transfer only the intended changes; do not blindly mirror the whole skills directory.
4. Review the diff and run the relevant checks below. Preserve exact provider grammar and source attributions. Never commit credentials, private user materials, generated outputs, or machine-specific backups.
5. Stage only the reviewed task files, inspect git diff --cached and git diff --cached --check, then create a descriptive commit. The owner has pre-authorized automatic commit and git push origin main after each validated change to the repository skills (h3-prompt-writing, kling-4-prompting, minimax-music-30, seedance-25, suno-song-builder, threejs-rendering) without pausing for confirmation. Do not publish unrelated staged work.
6. Read back the remote branch with git ls-remote origin refs/heads/<branch> and compare its SHA with the pushed local commit. Only report synchronization after they match. On a push/authentication failure, retain local work and report that GitHub is not yet updated.

A post-commit hook (.git/hooks/post-commit) and ./optimize_skills.sh (also wired to launchd com.glitterpixely.skills-autopush in --changed-only mode) automatically validate, sync installed copies in ~/.gemini/config/skills/, commit, and push after each skill change.

Validation

Run from this repository root:

python3 h3-prompt-writing/scripts/validate_coverage.py
python3 h3-prompt-writing/scripts/lint_h3_prompt.py --self-test
python3 seedance-25/scripts/validate_coverage.py
python3 seedance-25/scripts/prompt_lint.py --self-test
python3 minimax-music-30/scripts/validate_coverage.py
python3 minimax-music-30/scripts/lint_music_prompt.py --self-test
python3 threejs-rendering/scripts/validate_coverage.py
node threejs-rendering/scripts/physical.mjs

For Kling and Suno, check frontmatter and local reference links, and review the changed guidance. For shared documentation, verify links and instructions. Passing these checks is not proof of generated video or music quality.