roll-check

Detect and apply futures contract roll adjustments to preserve PnL continuity.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/kitfunso/omniskill --skill roll-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: roll-check
Source: https://github.com/kitfunso/omniskill/tree/main/skills/roll-check
Command: npx skills add https://github.com/kitfunso/omniskill --skill roll-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects and applies futures contract roll adjustments for active commodity positions to preserve PnL continuity by aligning signal_price with the rolled contract.

Core Features & Use Cases

  • Detect pending rolls in active positions and report the changes clearly.
  • Apply roll adjustments to signal data and synchronize updates across Supabase and local files.
  • Exclude non-rolling or flat positions to ensure safety and data integrity.

Quick Start

Run a dry-run to identify pending rolls, then confirm and apply adjustments as needed.

Frequently Asked Questions about roll-check

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

FAQPage Schema
How do I adjust futures contract rolls to preserve PnL continuity?

Futures contract rolls preserve PnL continuity by aligning signal_price with the rolled contract. The roll-check process detects pending rolls for active commodity positions, prompts for confirmation, and updates Supabase and local live_signal.json entries accordingly.

Why do my active commodity positions show incorrect PnL after a contract roll?

Incorrect PnL after a contract roll occurs when signal_price is not aligned with the newly rolled contract. Applying roll adjustments updates your signal data across Supabase and local files to restore PnL continuity.

How do I run a dry-run to detect pending futures rolls before applying changes?

To detect pending futures rolls, run a dry-run to identify active positions requiring adjustments. The process reports ticker and price changes clearly, allowing you to validate the roll data before applying any updates to your live environment.

Can I apply roll adjustments to flat or non-rolling commodity positions?

You cannot apply roll adjustments to flat or non-rolling positions. The process enforces safety by excluding these positions to ensure data integrity, requiring validation of ticker and price changes before applying rolls to active positions only.

Does this roll adjustment process work with Supabase and local JSON files?

The roll adjustment process synchronizes updates across both Supabase and local live_signal.json files. It detects pending rolls, reports the findings, and applies the confirmed adjustments simultaneously to your database and local signal data.

How do I force futures roll updates without manual confirmation prompts?

To force futures roll updates without manual confirmation, use the --force flag. This bypasses the confirmation prompt and directly applies the validated ticker and price changes to your active positions in Supabase and local live_signal.json files.