jev-pendulum

Designs and validates inverted pendulum balancing rigs in the OpenHarness viewer.

465|41|Updated Aug 4, 2026
One-click install
npx skills add https://github.com/autonomous-ai/openharness --skill jev-pendulum-autonomous-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jev-pendulum
Source: https://github.com/autonomous-ai/openharness/tree/main/store/agents/jev-pendulum/skills/pendulum
Command: npx skills add https://github.com/autonomous-ai/openharness --skill jev-pendulum-autonomous-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Tuning an inverted pendulum simulation rig by hand is guesswork: gravity, rod length, push authority, and gusts interact in ways that are hard to predict, and an invalid configuration file silently breaks the simulation. This Skill guides the design of pendulum.json rigs and verifies them so the balancing behavior is dramatic but fair. ## Core Features & Use Cases - Rig Design: Edit pendulum.json parameters (gravity, length, maxTorque, gustEvery/gustStrength, style line) and watch Jev adapt live in the viewer without restarting. - Rig Validation: Run node "$JEV_DSH/toolchain/check.mjs" to reject invalid configs (missing title, out-of-range values like gravity 0.5..30, length 0.2..3, stepMs 30..2000) and print the unrecoverable lean angle. - Direct Model Queries: Use toolchain/jev.mjs to ask Jev which push action steadies a given rod state before committing to a rig, with a deterministic mock when TYPESAFE_API_KEY is unset. - Use Case: Tune gravity from 5 to 10, add gusts, and confirm the rod visibly struggles and occasionally drops rather than standing like a statue or falling instantly. ## Quick Start Ask the agent to update pendulum.json with gravity 7 and moderate gusts, then run the check script and watch the viewer to confirm the rod wobbles but recovers.

Frequently Asked Questions about jev-pendulum

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

FAQPage Schema
How do I design an inverted pendulum rig in OpenHarness?

Edit pendulum.json to set gravity, rod length, maxTorque, gustEvery/gustStrength, and a style line describing the balancing strategy. The viewer watches the file and Jev adapts live, so no restart is needed.

How do I validate a pendulum.json configuration file?

Run node "$JEV_DSH/toolchain/check.mjs" from the workspace. It returns non-zero for invalid configs, enforces ranges like gravity 0.5..30 and length 0.2..3, and prints the lean angle past which the rod cannot be saved.

What gravity value makes the pendulum challenging but fair?

Gravity 4-5 never falls, 7 is tense, and 10 or higher topples the rod every few seconds. Shorter rod length and moderate gustStrength with gustEvery push the rig toward the edge without tipping it alone.

Can I query the balancing model without an API key?

Yes. Without TYPESAFE_API_KEY, toolchain/jev.mjs uses a deterministic mock for evaluate calls. Set the key to query live Jev for push-action decisions on a given rod state.

Why does my pendulum rig always stand perfectly still?

A rig that never wobbles is too easy: gravity is likely in the 4-5 range with weak gusts. Raise gravity toward 7 or higher, shorten the rod, or increase gustStrength to produce visible struggle and occasional drops.