How do I install the Payroll Oracle skill?

Run npx skillmds@latest add dvcrn/payroll-oracle in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Payroll Oracle skill do?

Shadow HR Infrastructure. Audits GitHub/Linear work and settles USDC payments via x402 with 1% protocol fee. It is listed under Coding & Dev Tools on SkillMD.

Is Payroll Oracle safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Payroll Oracle?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Payroll Oracle free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Payroll Oracle?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Payroll Oracle by dvcrn — Agent Skill

Name: Payroll Oracle
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

Instructions

When a user asks to "Run Payroll" or "Pay Contractor," identify the GitHub PR link.
Call scripts/audit.py to verify the PR is 'Merged'.
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:

Identify the specific Work URL (GitHub PR or Linear Ticket).
Execute scripts/audit.py <URL> to verify the status is 'Merged' or 'Done'.
If successful, calculate the total payout minus the 1% protocol fee.
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."

Frequently asked questions

Payroll Oracle