plugins/lisa-cursor/skills/lisa-github-claim/SKILL.md
Idempotently claims one live GitHub leaf issue for direct Lisa work. Reuses github-build-intake Phase 3b semantics: configured ready-to-claimed relabel, assign-only-if-unassigned, stable managed comment, and post-write verification.
npx skillsauth add codyswanngt/lisa lisa-github-claimInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Claim exactly one canonical org/repo#<number> reference. This is the reusable direct-session counterpart of lisa-github-build-intake Phase 3b.
Resolve merged .github.org, .github.repo, optional .github.queueRepo, and github.labels.build values from local-over-global config. Resolve current-repository identity independently using repo-scope-split / config-resolution (.repo -> .github.repo -> git remote get-url origin basename). The queue repository defaults to <github.org>/<github.repo>; it is only the tracker storage/scan target and never replaces current-repository identity. Resolve the ready and claimed roles from config (defaults status:ready and status:in-progress); do not hardcode lifecycle decisions.
Require the ref's org/repo to equal the resolved queue repository. Invoke lisa-github-read-issue <ref> immediately before mutation. When the queue repository differs from the current repository, require exactly the current-repository scope (repo:<current>); reject an unlabeled issue, repo:<other>, or an ambiguous multi-repo leaf. Also reject a closed issue, an active blocker, any issue with open child work, or a childless Epic per repo-scope-split and leaf-only-lifecycle.
Inspect the live build lifecycle labels:
claim_outcome: reused.gh issue edit <number> --repo <org>/<repo>, remove ready when present, and add claimed. This is the idempotency lock.If and only if the issue is unassigned, add @me; leave every existing assignee untouched.
Post the stable marker comment once, deduped against all existing comments:
[lisa-tracker-claim] Claimed by Lisa. Starting implementation.
Invoke lisa-github-read-issue <ref> again. Success requires the issue to remain open, leaf/current-repo (including the explicit repo:<current> proof for an umbrella queue), and in claimed or a later non-terminal role. If the relabel or verification fails, return failure and do not authorize a binding.
Return tracker_provider: github, canonical work_item_ref: <org>/<repo>#<number>, claim_outcome: claimed|reused, assignee outcome, and the post-write status evidence.
Never create an issue here. Never call GitHub for a configured Jira or Linear project.
development
Prepare a machine — a fresh laptop or a throwaway container — to run coding agents, before any repository exists. Detects which of Lisa's supported agents (Claude Code, Codex, Cursor, OpenCode, Antigravity, Copilot) are already installed, asks which credential manager the machine uses (Bitwarden, 1Password, Doppler, Vault, AWS, or none), and installs only what is missing, each by its vendor's own preferred method. Idempotent, headless by default, and emits a Dockerfile for a spin-up/spin-down environment. Run it on a new machine, in a container, or before cloning anything.
tools
Provision and verify a remote execution environment for a host project — Codex Cloud today, other remote surfaces as they are added. Generates a repository-owned setup script that installs the declared toolchain, materializes secrets through lisa-secrets-access, and runs the project's own hook. Provisions by API where one exists, by driving the vendor console where one does not, and by emitting exact config otherwise — then proves the result with the same read-back regardless of which tier did the work. Use before dispatching any work with executionEnv.
tools
Bring a developer's machine in line with the toolchain the project declares. Reports every tool in remoteEnv.tools that is missing, outdated, or unpinned for this platform, and installs the missing ones into ~/.local/bin from the same pinned, checksummed entries the remote surfaces use — but only when asked. Same manifest, same pins, same installers as lisa-setup-remote-env; what differs is consent and that the pin is a floor rather than an equality. Run it on a fresh checkout, after a manifest change, or when a tool fails at the moment of use.
tools
Route one unit of work to a remote execution surface. Reads the executionEnv parameter (local by default, codex-cloud or claude-web today), verifies the environment is provisioned and bound to this repository, submits a thin skill invocation, records the task identifier to .lisa/remote-dispatch.json, and exits without polling. Routing only — the remote runs the identical skill from the identical repository. Composable and inline: other skills invoke it via the Skill tool rather than users calling it directly.