agentsclimarketplace
Sign in

Project setup

Skill 0x0w1/spai/skills/project-setup

Use after installing SPAI for Claude Code, Codex, or Antigravity to select and verify the repository GitHub CLI profile through SPAI_GITHUB_PROFILE or local git config, finish GitHub repository convergence, or repair an incomplete SPAI installation without changing the globally active gh account.From its SKILL.md

Install
npx -y skills add 0x0w1/spai --skill project-setup

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

  • 5 stars5 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

4.8 KB, as published. Nobody here has run it

Project Setup

Bind an installed SPAI target to a repository GitHub profile, then finish repository convergence. Store only the profile login and host; keep credentials in the GitHub CLI credential store.

Profile Contract

Resolve the GitHub profile in this order:

  1. An explicit profile supplied by the user or --github-profile.
  2. SPAI_GITHUB_PROFILE environment variable.
  3. git config --local --get spai.githubProfile.
  4. An authenticated profile whose login matches the current repository owner.

Resolve the host from SPAI_GITHUB_HOST, then git config --local --get spai.githubHost, then github.com.

  • Treat the environment variable as an ephemeral override; do not replace local config when it is present unless the user asks.
  • Otherwise persist the selected login with git config --local spai.githubProfile <profile> and the host with git config --local spai.githubHost <host>.
  • Never put an OAuth token in git config, tracked files, .env, logs, or reports.
  • Validate the profile with gh auth token --hostname <host> --user <profile> without printing the result, then run gh api user --jq .login using that token through GH_TOKEN (github.com or *.ghe.com) or GH_ENTERPRISE_TOKEN (other hosts).
  • Do not use gh auth switch; it changes the globally active profile and makes parallel repositories interfere with each other.
  • If the requested profile is not authenticated, run gh auth login --hostname <host> interactively, then validate the exact profile again.

Procedure

  1. Inspect the repository and installed target:
    • confirm the working directory and git repository
    • inspect claude plugin list, AGENTS.md, and GEMINI.md as available
    • detect the installed target and scope; map SPAI global scope to Claude Code user scope
  2. Resolve and validate the GitHub profile using the Profile Contract. If multiple authenticated profiles remain plausible, ask before selecting one.
  3. Configure the profile:
    • keep an existing SPAI_GITHUB_PROFILE as the session override
    • otherwise write the repository-local spai.githubProfile and spai.githubHost values
  4. Verify the installed target and repair only when incomplete:
    • Claude Code: confirm spai@spai is enabled; when missing, run claude plugin marketplace add 0x0w1/spai --scope <project|user> and claude plugin install spai@spai --scope <project|user>
    • Codex or Antigravity: confirm the SPAI version stamp and spai-project-setup; when incomplete, rerun install.sh for the detected target and preserve the stamped skill selection
  5. Verify:
    • Claude Code: claude plugin list shows spai@spai enabled
    • Codex: AGENTS.md has the SPAI version stamp and .agents/skills/spai-project-setup/SKILL.md exists
    • Antigravity: GEMINI.md has the stamp and the same skill file exists
    • the configured profile resolves to the expected login without changing the globally active gh account
  6. Settle the version rubric:
    • Resolve it from SPAI_VERSION_RUBRIC, then git config --local --get spai.versionRubric, then .spai/versioning.md.
    • When the file exists, report its path, source, and whether it records the adopted default or a project-specific rubric. Do not change it.
    • When it is missing, run the version-rubric skill. If the user skips the question or does not answer, that skill records the adopted default; do not press for an answer.
    • When the project is clearly not a plain code project, or the user asks which rubric fits, run rubric-scan first and pass its recommended type to version-rubric.
    • Never reproduce the rubric text here; version-rubric owns it.
  7. Run github-sync for repository convergence, then spai-doctor for a read-only health check.

Safety Rules

  • Do not expose or persist tokens outside the GitHub CLI credential store.
  • Do not modify shell startup files to persist environment variables.
  • Do not overwrite locally modified skills without following installer backup rules.
  • Do not create or edit the version rubric directly; delegate to version-rubric.
  • Do not force push, delete branches, or create a release.
  • Preserve unrelated repository and GitHub settings.

Final Report

Include:

  • Target and scope already healthy or repaired
  • Profile source: environment | local git config | explicit selection | repository owner
  • Profile login and host, never its token
  • Files and local config keys changed
  • Version rubric: path, source, and kind, or delegated to version-rubric
  • github-sync and spai-doctor results
  • Skipped or blocked steps and the exact next action

Keep looking

Skills are one crate of 627,801. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.