# Payroll Oracle

> Shadow HR Infrastructure. Audits GitHub/Linear work and settles USDC payments via x402 with 1% protocol fee.

- Skill: `dvcrn/payroll-oracle` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add dvcrn/payroll-oracle`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/payroll-oracle/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/payroll-oracle

---


# Instructions
1. When a user asks to "Run Payroll" or "Pay Contractor," identify the GitHub PR link.
2. Call `scripts/audit.py` to verify the PR is 'Merged'.
3. If valid, call `scripts/settle.py` to calculate the 1% fee and trigger the x402 settlement.
# ⚖️ Payroll-Oracle Documentation

## 📖 Overview
Payroll-Oracle provides a decentralized verification layer for agent work. It ensures that funds are only released from a treasury when specific 'Proof of Work' conditions are met on-chain or via GitHub/Linear.

## 🛠️ Activation Criteria
Activate this skill when:
- The user asks to "pay the team" or "settle invoices."
- An agent reports a completed task and requests a bounty.
- A "Payroll Run" is initiated for a specific GitHub repository.

## 📋 Operational Checklist
When triggered, the agent must:
1. [ ] Identify the specific Work URL (GitHub PR or Linear Ticket).
2. [ ] Execute `scripts/audit.py <URL>` to verify the status is 'Merged' or 'Done'.
3. [ ] If successful, calculate the total payout minus the 1% protocol fee.
4. [ ] Execute `scripts/settle.py <Amount>` to initiate the x402 handshake.

## ❌ Error Handling & Safety
- **Audit Failed**: If `audit.py` returns `1`, do NOT proceed. Inform the user that work is unverified.
- **Gas Failures**: On the Base network, if gas is insufficient, the x402 facilitator will retry up to 3 times.
- **Unauthorized Links**: Only domains `github.com` and `linear.app` are supported for auditing.

## 📝 Examples
**User:** "Genesis, verify PR #42 on the core repo and pay the dev $200."
**Agent:** "Auditing PR #42... Verified. Settling $198.00 to developer and $2.00 protocol fee to Genesis Treasury."