feat(skill): provide TS-aware agent guidance and explicit skill setup #25

The separate session-peer-skill currently describes Python runtime versions and flags not available in TS 0.1.0. Installing it unmodified for npm users produces incorrect commands. This is a companion integration gap, separate from the README badges/quick-start PR #15.

Scope and completion criteria

• Define runtime detection using implementation/version/capabilities; provide either a TS-specific skill or a reviewed dual-runtime skill in the companion repository.
• Cover installed-command/PATH ownership, TS JSON/agent/home requirements, list-before-send, dry-run, explicit home preservation and unsupported doctor/wake/Antigravity/Relay behavior for each supported TS version.
• Document or implement a user-invoked skill setup command with explicit agent/scope/version choices and an exact reviewed installation command. Keep runtime and skill lifecycle independently managed.
• Installation through npm --ignore-scripts must remain functional. Do not rely on lifecycle hooks/postinstall or automatically overwrite Python-oriented skill instructions.
• Validate examples against TS CLI fixtures and verify isolated skill install/update/uninstall without editing production agent homes. Coordinate a companion PR before claiming the skill is available.

Dependencies and priority

Dependencies: None; implement within the existing guarded local/SSH contract.

Planning priority: P1 (P1 = foundational/common workflow; P2 = subsequent or optional capability). Milestone is a planning group, not a release or deployment approval.

Evidence

Compared Python 1.0.2 (47c2371) with TS 0.1.0 (0edc4f8), both main heads verified on 2026-09-27.

• session-peer/README.md
• session-peer-ts/README.md
• session-peer-ts/src/cli.ts
• Companion skill at f43a500