[new-plugin] livermore-perps v1.0.0

[AstonRemy]

Plugin Submission

Plugin name: livermore-perps
Version: 1.0.0
Type: new-plugin

Checklist

• plugin-store lint passes locally with no errors
• I have read the Development Guide
• My plugin does NOT use reserved prefixes (okx-, official-, plugin-store-)
• LICENSE file is included
• SKILL.md has YAML frontmatter with name and description

What does this plugin do?

Time-distributed exit primitive for Hyperliquid perpetual positions. Splits a position close into N reduce-only market orders distributed over a configurable duration (5 min – 4 h) to minimize market impact and slippage on thin liquidity pairs.

This is a submission for the Plugin Store Developer Challenge Season 1 (deadline 2026-05-07 23:59 UTC+8). Requesting expedited review.

The skill is the perpetual futures companion to onchain-livermore (a spot exit-discipline skill being prepared for separate submission). Same philosophy — exit-only, decision layer over official skills, journalled fills — different venue. Never opens positions, never increases leverage.

Which onchainos commands does it use?

This skill composes the official hyperliquid-plugin (installed via npx skills add okx/plugin-store --skill hyperliquid-plugin). It does not call onchainos subcommands directly. Through the hyperliquid-plugin, the following commands are orchestrated:

• hyperliquid positions — read open positions, sizes, sides
• hyperliquid prices — current mid prices for slippage checks
• hyperliquid order (with reduce_only: true) — issue each TWAP slice as a reduce-only market order
• hyperliquid orders — reconcile slice state against the order book

The skill also reads/writes to local state at ~/.livermore-perps/ (config, journal). No external HTTP calls beyond what hyperliquid-plugin already makes; api_calls: [] in plugin.yaml.

Security Considerations

Risk level: advanced — this skill issues market orders autonomously across a duration.

Safeguards in place:

• Dry-run mode is the default. Live execution requires --dry-run false AND --confirm per session.
• Per-slice slippage cap (--max-slippage-per-slice) — if a quote exceeds the cap, the slice is aborted and skipped (not retried at relaxed slippage). Defaults to 1.0%.
• Pause-on-failure threshold — 3 consecutive slice failures pause the entire schedule and surface to the user. No silent looping.
• Reduce-only orders only. Every issued order has reduce_only: true. The skill cannot accidentally open new exposure or flip the position direction.
• Maximum duration capped at 4h without --force flag.
• Self-custodial. Private keys never leave Agentic Wallet TEE. Skill produces order requests; wallet signs.
• No external API calls. All data flows through hyperliquid-plugin. No third-party telemetry.
• Risk disclaimer prominently included in SKILL.md (perpetual leverage risk, TWAP-vs-market-direction risk, no fill guarantees).
• Honest comparison — simulate command estimates TWAP cost vs single-market-close cost and recommends the cheaper option. The skill explicitly tells users when TWAP is the wrong tool.

Testing

• Local lint: structure, frontmatter, naming, version consistency, file sizes — all verified.
• Manual schema validation: plugin.yaml parsed against schema_version 1; .claude-plugin/plugin.json validated; SKILL.md frontmatter validated; name/version consistency confirmed across all three files.
• Required SKILL.md sections (Overview, Pre-flight Checks, Commands, Error Handling, Security Notices) — all present and reviewed against the FOR-DEVELOPERS.md template.
• Advanced-tier requirements (dry-run, slippage caps, pause-on-failure, prominent disclaimer) — all present.
• Functional behaviour is documented in SKILL.md but has not been end-to-end tested against a live Hyperliquid position prior to submission. The author commits to running an end-to-end live test on a small position immediately after merge and reporting results in a follow-up PR comment if any issues surface.

[AstonRemy]

Hey!

Requesting expedited review under the Plugin Store Developer Challenge Season 1 (deadline 2026-05-07 23:59 UTC+8, ~3h remaining).

Skill is Skill-only (no binary), composes official hyperliquid-plugin, no external API calls. All advanced-tier requirements present (dry-run default, slippage caps, pause-on-failure, prominent disclaimer).

Happy to push fixes immediately if anything blocks. Available on Telegram at @voshchansky