fulcra-agent-forge

Mirror GitHub PR state onto a Fulcra team store as review evidence and auto-approve merged PRs.

10|1|Updated May 21, 2026
One-click install
npx skills add https://github.com/ashfulcra/fulcra-tools --skill fulcra-agent-forge-ashfulcra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fulcra-agent-forge
Source: https://github.com/ashfulcra/fulcra-tools/tree/main/skills/fulcra-agent-forge
Command: npx skills add https://github.com/ashfulcra/fulcra-tools --skill fulcra-agent-forge-ashfulcra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a code review's artifact is a GitHub pull request, the review status on the Fulcra team store can drift from reality — a PR merges but no human files a verdict, or feedback scattered across GitHub's review surfaces goes unseen. This Skill keeps review status synchronized with the forge so agents and humans see accurate state. ## Core Features & Use Cases - PR State Mirroring: Writes one idempotent evidence shard per PR state transition (OPEN, MERGED, CLOSED) so coord-engine review status reflects the forge. - Auto-Verdict on Merge: When a PR merges, a verdicts/forge.md approval is written automatically, folding into the review tally like any reviewer while human CHANGES verdicts still dominate. - Three-Surface Feedback Sweep: Polls formal reviews, inline review comments, and conversation comments on every pass, mirroring each item to an idempotent shard keyed by its GitHub node id. - Use Case: An agent team reviews each other's PRs through Fulcra. Run coord-engine forge mirror <team> on a heartbeat so merged PRs auto-close their reviews and new reviewer feedback surfaces in needs-me until acknowledged. ## Quick Start Ask the agent to run a forge mirror pass over your Fulcra team so current GitHub PR states are folded into review evidence and pending feedback is swept.

Frequently Asked Questions about fulcra-agent-forge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync GitHub PR status with a Fulcra review?

Run `coord-engine forge mirror <team>` to perform one idempotent pass over all PR-backed reviews. It writes evidence shards for each PR state transition and auto-approves the review when its PR merges.

How do I track feedback on a GitHub PR across all comment types?

Use `coord-engine forge feedback <team>`, which sweeps all three GitHub surfaces: formal reviews, inline review comments, and conversation comments. Each item is mirrored to an idempotent shard keyed by its GitHub node id so re-runs converge without duplicates.

Does the forge mirror work without the GitHub CLI authenticated?

No. Without an authenticated `gh`, `forge mirror` is a clean no-op that exits 0 and writes no evidence, so review status stays stale. Run `gh auth login` first, then re-run the mirror pass.

Can I watch a GitHub PR that has no review document?

Yes. Register it with `coord-engine forge watch <team> <pr-url> --agent <me>` and it joins the sweep target set. Feedback on watched PRs surfaces as `[FORGE]` items in `needs-me` and persists until acknowledged.

Does the automatic forge approval override human review verdicts?

No. The forge approval folds into the review tally like any reviewer, but a human CHANGES verdict still dominates and blocks the review. The forge never fabricates state when a GitHub call fails.