@genart-dev/plugin-poses

Pose reference and practice plugin for genart.dev — overlay OpenPose BODY_25 skeletons on any sketch, run timed practice sessions with auto-advancing poses, and annotate with landmarks, angles, and action lines. All layers are non-destructive guides. Includes 88 preset poses across 10 categories and 8 MCP tools for AI-agent control.

Part of genart.dev — a generative art platform with an MCP server, desktop app, and IDE extensions.

Install

npm install @genart-dev/plugin-poses

Usage

import posesPlugin from "@genart-dev/plugin-poses";
import { createDefaultRegistry } from "@genart-dev/core";

const registry = createDefaultRegistry();
registry.registerPlugin(posesPlugin);

// Or access individual layer types, pose library, and utilities
import {
  skeletonLayerType,
  timerLayerType,
  annotationsLayerType,
  posesMcpTools,
  getAllPoses,
  filterPoses,
  getRandomPoses,
  getPoseById,
  getPoseCategories,
  BODY_25_NAMES,
  LIMB_CONNECTIONS,
} from "@genart-dev/plugin-poses";

Layer Types (3)

Common Guide Properties

Shared by all three layer types:

Pose Skeleton (poses:skeleton, guide)

OpenPose BODY_25 skeleton overlay with 25 keypoints and 24 limb connections. Supports three rendering styles and four color modes.

Practice Timer (poses:timer, guide)

Countdown timer for timed practice sessions with pose counter and progress bar.

Study Annotations (poses:annotations, guide)

Overlays for anatomical study — landmark labels, angle arcs, distance lines, and gesture action lines.

Test Render

16-panel montage showing all layer types with variations:

• Row 1: Skeleton styles — stick, proportional, silhouette, mirrored with bounding box
• Row 2: Color modes — uniform, limb-groups, left-right, rainbow
• Row 3: Pose categories — standing, seated, dynamic, dance (from 88 presets across 10 categories)
• Row 4: Timer layer, landmark annotations, angle annotations, action-line annotations

Regenerate with node render-test-poses.cjs (requires canvas dev dependency).

All 88 Poses

Every preset pose grouped by category — 10 rows, one per category. Regenerate with node render-test-all-poses.cjs.

Pose Library (88 presets)

Each preset contains 25 BODY_25 keypoints with normalized (0-1) coordinates. Filter by tags:

import { filterPoses, getRandomPoses } from "@genart-dev/plugin-poses";

// Filter by category, view, difficulty, energy, symmetry, weight
const dynamicFront = filterPoses({ category: "dynamic", view: "front" });

// Seeded random selection with optional filter
const session = getRandomPoses(5, { difficulty: "beginner" }, 42);

MCP Tools (8)

Exported Utilities

Shared BODY_25 constants and drawing helpers are exported for reuse:

• BODY_25_NAMES — 25 keypoint names as const tuple
• LIMB_CONNECTIONS — 24 limb connections as [KeypointName, KeypointName][]
• LIMB_GROUPS / LIMB_GROUP_COLORS — 6 body groups with colors
• PROPORTIONAL_WIDTHS — per-limb-segment width multipliers
• denormalizeKeypoints() — convert normalized coords to pixel bounds
• mirrorKeypoints() — horizontal flip
• computeAngle() — three-point joint angle
• computeCenterOfGravity() — average keypoint position
• computeSymmetryScore() — left-right symmetry metric

Types

import type {
  KeypointName,
  Keypoint,
  KeypointMap,
  PoseData,
  PoseCategory,
  PoseTags,
  PosePreset,
  SessionData,
  AnnotationItem,
} from "@genart-dev/plugin-poses";

Related Packages

Support

Questions, bugs, or feedback — support@genart.dev or open an issue.

License

MIT