Requirements

Node.js 20 or newer is the only runtime prerequisite. The installed calculation runners do not need this repository or a network connection.

Installer commands

npx aerospace-skills install
npx aerospace-skills update
npx aerospace-skills doctor
npx aerospace-skills remove

Install and update stage complete skill folders before replacing a managed version. Remove deletes only folders recorded in the Aerospace Skills manifest.

Interactive selection

The installer checks both the current project and your home directory, reports the detected agent folders, and preselects them in a keyboard-controlled checklist. Use the arrow keys to move, space to toggle an agent, and enter to continue. A second choice installs into the current project or globally for the current user.

Unattended installation

npx aerospace-skills install --agent codex --scope project --yes

Option	Meaning
`--agent`	Comma-separated targets: codex, claude, cursor, gemini, copilot, or opencode.
`--scope`	Choose `project` or `global`.
`--yes`	Accept detected agents and default to project scope without prompts.

Installation destinations

Agent	Project	Global
Codex	`.agents/skills`	`~/.agents/skills`
Claude Code	`.claude/skills`	`~/.claude/skills`
Cursor	`.cursor/skills`	`~/.cursor/skills`
Gemini CLI	`.gemini/skills`	`~/.gemini/skills`
GitHub Copilot	`.github/skills`	`~/.copilot/skills`
OpenCode	`.opencode/skills`	`~/.config/opencode/skills` or configured XDG/OpenCode directory

Project and global installs preserve unrelated skills and agent configuration. Do not run global installation with sudo; supported destinations live under the current user's home directory.

Use through an agent

Ask for the engineering result in ordinary language and provide the inputs you know. For example:

Calculate a Hohmann transfer from a 300 km circular Earth orbit to geostationary radius. Show both burns, transfer time, units, assumptions, and warnings.

The relevant skill tells the agent which local operation to run and requires the complete output envelope to remain visible.

Run a skill directly

node scripts/run.mjs hohmann_transfer --input-json '{"r1_m":6678137,"r2_m":42164137}'

Successful stdout contains one JSON object with ok, operation, result, units, assumptions, warnings, and provenance. Invalid input writes a useful error to stderr and exits nonzero.

Compatible agents

The installer detects Codex, Claude Code, Cursor, Gemini CLI, GitHub Copilot, and OpenCode in both the current project and your home directory. Its interactive checklist lets you choose multiple agents, followed by a project or global installation. For scripts, pass a comma-separated --agent value with --scope and --yes.

Troubleshooting

If an agent is not detected, select it manually or pass --agent. If installed skills do not appear, run doctor with the same agent and scope, then restart the coding agent. A project install is visible only from that project.

Safety

Aerospace Skills supports education, research, and preliminary engineering. It is not approved for navigation, flight dispatch, autonomous control, launch clearance, certification, regulatory compliance, or any safety-of-life decision. Validate every result with authoritative methods for the intended use.

Coming from Aerospace MCP?

The MCP server, HTTP API, Python imports, old public CLI, and container deployment are no longer supported. Follow the migration guide.