Skip to content
cccskills
FreePublished on GitHub

neondeck-handoff

Register completed local agent work with Neondeck so Neon can watch PRs, show notes, and queue bounded review assistance when allowed.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Neondeck Handoff

Use this skill when you are an external local coding agent working in a repository that the user tracks with Neondeck.

Before using it, check that the CLI exists:

command -v neondeck >/dev/null 2>&1

If neondeck is missing, do nothing and do not tell the user to install it unless they asked about Neondeck.

After You Push A PR

When you push or update a pull request for a Neondeck-tracked repo, run:

neondeck register-pr <owner/repo#number> --from <agent-name> --note "<one-line summary>" --json

Use a stable lowercase source name such as claude-code, codex, kilo, or ci:github-actions. The CLI stores it as attribution such as external:codex unless you already use a ci: or external: prefix.

The JSON contract is:

{
  "ok": true,
  "action": "handoff_pr_register",
  "changed": true,
  "id": "owner/repo#123",
  "message": "Registered owner/repo#123 from codex.",
  "deckUrl": "/"
}

If ok is false, read message, requires, and errors. Do not retry in a loop. Duplicate PR registration is safe and returns success.

Add --review only when the user or repo policy wants Neon to queue bounded PR review assistance. It may start a model-backed Flue workflow that reads PR facts and creates local reports/draft comments, but it does not submit a GitHub review.

After Significant Work Without A PR

Leave a bounded note:

neondeck note "Finished local refactor; no PR was pushed." --from <agent-name> --repo <repo-id-or-owner/name> --level ready --json

Levels are info, ready, and attention. Notes are capped to 4 KiB. Use attention only when the user needs to act.

Release Watching

To watch the default branch or a source PR through release checks:

neondeck watch-release <repo-id-or-owner/name> --from <agent-name> --json
neondeck watch-release <repo-id-or-owner/name> --source-pr <owner/repo#number> --from <agent-name> --json

Do not use handoff commands for execution, approvals, pushes, provider changes, or remote ingest. They are only for attributed local registration into Neondeck.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

flue

Free

Use when building, debugging, reviewing, migrating, or documenting Flue projects, including agents, hooks, tools, skills, subagents, sandboxes, routing, channels, persistence, schedules, observability, React clients, deployment targets, and CLI usage. Find and read version-matched Flue documentation before relying on API details.

The English summary is being prepared. Showing the original description.

pandemicsyn/neondeck8Updated Oct 22, 2026

Choose between deterministic GitHub API tools, local git facts, and approved gh CLI workflows in Neondeck.

The English summary is being prepared. Showing the original description.

pandemicsyn/neondeck8Updated Oct 22, 2026

Guidance for Neondeck's /fix-ci operation when repairing failing PR checks in a managed worktree.

The English summary is being prepared. Showing the original description.

pandemicsyn/neondeck8Updated Oct 22, 2026

Guidance for Neondeck docs-drift fix handoffs when updating documentation from drift reports.

The English summary is being prepared. Showing the original description.

pandemicsyn/neondeck8Updated Oct 22, 2026

Guidance for Neondeck issue-triage digests and human-owned drafted issue replies.

The English summary is being prepared. Showing the original description.

pandemicsyn/neondeck8Updated Oct 22, 2026

Guidance for Neondeck's /review-pr agent when preparing a human-owned review briefing and draft comments.

The English summary is being prepared. Showing the original description.

pandemicsyn/neondeck8Updated Oct 22, 2026

See all skills by pandemicsyn

Report a problem with this skill