← Back to Skills Marketplace
skylinehk

Air Route Calculator - Projected Flight Maps

by Gerald He · GitHub ↗ · v1.3.22 · MIT-0
cross-platform ⚠ suspicious
131
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install circulus-map-offline
Description
Use when the user wants aviation route maps, ETOPS-aware route analysis, projection comparisons, airport lookup, or SVG map rendering through a local Circulu...
README (SKILL.md)

Circulus Map - air route calculation with projected map

Use this skill when the task is about aviation route planning, map projections, airport lookup, ETOPS, or generating shareable SVG route maps through a local Circulus Map setup.

Hosted destination (next release)

Quick start

  • Before using tools, make sure the local app is running with npm run dev and the MCP worker is running with npm run mcp:dev.
  • Expect the local MCP endpoint at http://127.0.0.1:8788/mcp.
  • For simple requests, call map.solve_query with shorthand input like JFK-LHR or 800nm@DEN.
  • For advanced requests, build a MapSpecV1 object and call map.solve_spec.
  • Use map.search_locations before solving when the user is unsure about codes or city names.
  • Use map.get_airport when you need a single airport record with coordinates and runway metadata.
  • Use map.render_svg only after the route/spec is stable.

Tool selection

  • map.search_locations: best first step for ambiguous airport/city input.
  • map.solve_query: fastest path for route-only requests and simple range rings.
  • map.solve_spec: use when the user cares about projection, ETOPS, labels, markers, or multiple paths.
  • map.list_scenarios: use when the user asks for examples or wants a starting point.
  • map.render_svg: use for final export-ready output, not exploration.

Resources

  • Read circulus://mapspec/schema before authoring a non-trivial MapSpecV1.
  • Read circulus://projection/guide for projection choices.
  • Read circulus://scenario/catalog and circulus://api/examples when you need examples quickly.

References

  • For local setup details and offline packaging expectations, read references/local-setup.md.
  • For quick query and spec-writing guidance, read references/mapspec.md.
  • For sample payloads, inspect assets/examples when bundled with this skill package.

Guardrails

  • Stay within the MCP tool surface; do not invent unsupported write operations.
  • Do not ask the MCP server to proxy arbitrary URLs or tile providers.
  • Prefer map.solve_query over map.solve_spec unless explicit control is needed.
  • If the local MCP server is unreachable, help the user restore the local app and worker before retrying tool calls.
Usage Guidance
This package appears to be a local/offline-only Circulus MCP client and is coherent with its description. Before using it: (1) verify you run the MCP worker locally at http://127.0.0.1:8788/mcp (the skill expects that endpoint); (2) you'll need to run the project locally (npm run dev / npm run mcp:dev) — the skill does not auto-install anything; (3) confirm the MCP URL is localhost and not repointed to an external host (if someone changes the MCP endpoint to a remote server, the agent could send local queries off-host); and (4) note the skill requests no credentials and is suitable for air-gapped or privacy-sensitive workflows. If you need higher assurance, inspect the actual running MCP worker code (not included here) before sending sensitive data through it.
Capability Analysis
Type: OpenClaw Skill Name: circulus-map-offline Version: 1.3.22 The skill is a legitimate aviation route planning tool designed to interact with a local MCP server at 127.0.0.1:8788. The instructions in SKILL.md and the configuration in agents/openai.yaml are strictly aligned with the stated purpose of offline mapping and ETOPS analysis, with no evidence of data exfiltration, malicious command execution, or harmful prompt injection.
Capability Assessment
Purpose & Capability
Name/description match the asset contents and instructions. All declared behavior (route solving, ETOPS, projection, SVG rendering) is supported by the provided docs and example payloads. No requested env vars, binaries, or unrelated capabilities are present.
Instruction Scope
SKILL.md instructs the agent to talk to a local MCP endpoint, use specific MCP tool calls (map.solve_query, map.solve_spec, etc.), and avoid proxying arbitrary URLs. It references local paths and startup commands only; it does not instruct reading unrelated files or exfiltrating data.
Install Mechanism
No install spec or remote downloads are present — this is an instruction-only skill with documentation on running the local app (npm run dev / npm run mcp:dev). No archives or external URLs are used for installs.
Credentials
No required env vars, credentials, or config paths are declared. references/local-setup.md suggests local env vars for convenience, but these are optional and local-only; nothing requests secrets or unrelated service credentials.
Persistence & Privilege
The skill is not marked always:true and does not request elevated platform privileges. The included agents/openai.yaml sets allow_implicit_invocation: false for that agent, while platform flags show the normal default (disable-model-invocation: false); there is no evidence the skill modifies other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install circulus-map-offline
  3. After installation, invoke the skill by name or use /circulus-map-offline
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.3.22
SEO rename: capability-first display name.
v1.3.21
Rename display name to Circulus Map - air route calculation with projected map.
v1.0.1
Add Desk.Travel destination links and stronger traffic-oriented usage guidance.
v1.0.0
Initial release: professional offline aviation route mapping skill with safety and local-runtime guardrails.
Metadata
Slug circulus-map-offline
Version 1.3.22
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is Air Route Calculator - Projected Flight Maps?

Use when the user wants aviation route maps, ETOPS-aware route analysis, projection comparisons, airport lookup, or SVG map rendering through a local Circulu... It is an AI Agent Skill for Claude Code / OpenClaw, with 131 downloads so far.

How do I install Air Route Calculator - Projected Flight Maps?

Run "/install circulus-map-offline" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Air Route Calculator - Projected Flight Maps free?

Yes, Air Route Calculator - Projected Flight Maps is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Air Route Calculator - Projected Flight Maps support?

Air Route Calculator - Projected Flight Maps is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Air Route Calculator - Projected Flight Maps?

It is built and maintained by Gerald He (@skylinehk); the current version is v1.3.22.

💬 Comments