plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "satcat",
  "version": "1.0.4",
  "description": "Explore the Satcat satellite catalog in ChatGPT: find and compare satellites, plot TLE history, view them on a 3D globe, chart separation and predict ground passes.",
  "author": {
    "name": "Kayhan Space Corp.",
    "email": "support@satcat.com",
    "url": "https://www.satcat.com"
  },
  "homepage": "https://www.satcat.com",
  "keywords": [
    "satellites",
    "orbits",
    "TLE",
    "space situational awareness",
    "space"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Satcat",
        "shortDescription": "Explore satellites and orbits",
        "longDescription": "Satcat by Kayhan Space brings the Satcat satellite catalog into ChatGPT. Find satellites by name, NORAD ID, international designator, owner, country, mission or orbital parameters. Retrieve latest or historical TLEs, compare two to four satellites, plot orbital-element history, and show selected satellites or filtered groups on an interactive 3D globe. Chart the separation and radial, in-track and cross-track (RIC) components between satellites, track GEO longitude history and neighbors, find satellites in similar or shared orbital planes, and predict geometric ground passes for observer coordinates you provide. Find when satellites can be seen from one or more locations: passes above an elevation mask, and times when the site is dark while the satellite is sunlit, optionally filtered by weather.\n\nSatcat is built for satellite operators, space situational awareness analysts, researchers and students. A Satcat account is required: sign in when ChatGPT asks you to connect. Results come only from catalog data your account can access.\n\nLimitations: results are sampled predictions from catalog TLEs. Satcat in ChatGPT does not perform conjunction screening or collision-risk assessment. Ground passes are geometric line-of-sight predictions and do not account for weather or optical visibility. Visibility analysis does not assess imaging, SAR or RF access. Catalog classifications do not establish nationality or military status. Large selections are paged or bounded, and truncation, stale TLEs and unavailable values are always reported.",
        "developerName": "Kayhan Space Corp.",
        "category": "Education & Research",
        "capabilities": [
          "Search the satellite catalog",
          "Retrieve latest and historical TLEs",
          "Compare satellites",
          "Plot orbital-element history",
          "Show satellites on a 3D globe",
          "Chart separation and RIC components",
          "Track GEO satellites and neighbors",
          "Find satellites in similar orbits",
          "Predict geometric ground passes",
          "Analyze satellite visibility from ground locations"
        ],
        "websiteURL": "https://www.satcat.com",
        "supportURL": "https://kayhan.space/contact",
        "privacyPolicyURL": "https://www.satcat.com/privacy-policy#ai-app",
        "termsOfServiceURL": "https://www.satcat.com/terms-of-use",
        "defaultPrompt": [
          "Show me HawkEye 360 satellites on the globe.",
          "Plot ISS apogee altitude and inclination over the last 30 days.",
          "Show the separation between HAWK-A and HAWK-B over the past 24 hours."
        ],
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "demo_recording_url": "https://youtu.be/qJnSDSAAx6I",
        "test_cases": {
          "positive": [
            {
              "description": "Show a business's satellites on the interactive globe",
              "prompt": "Using Satcat, show me HawkEye 360 satellites on the globe.",
              "tools_triggered": "satcat_show_globe (optionally after satcat_globe_filter_options)",
              "expected_behavior": "Opens the interactive 3D globe with the HawkEye 360 satellites in the catalog. The reply states how many satellites were selected and their TLE source epochs, and reports any satellites without usable TLEs instead of dropping them silently."
            },
            {
              "description": "Analyze when two satellites are visible from given coordinates",
              "prompt": "Using Satcat, which of the ISS and NOAA 20 are visible from 39.7 N, 104.9 W over the next 24 hours?",
              "tools_triggered": "search_satellites, analyze_visibility",
              "expected_behavior": "Resolves both satellites to NORAD IDs and returns, for 39.7 N, 104.9 W over the next 24 hours, each satellite's passes above the elevation mask and the intervals when the site is dark while the satellite is sunlit, with UTC times, peak elevation and TLE source epochs. No job is created, and the reply notes these are TLE-based predictions."
            },
            {
              "description": "Plot several orbital elements over time",
              "prompt": "Using Satcat, plot ISS apogee altitude and inclination together over the last 30 days.",
              "tools_triggered": "satcat_orbit_history",
              "expected_behavior": "Shows one chart with both apogee altitude in km and inclination in degrees on separate axes over the last 30 days. Missing samples appear as gaps, and any truncation of the TLE history is reported."
            },
            {
              "description": "Chart separation and RIC components between two satellites",
              "prompt": "Using Satcat, show the separation distance between HAWK-A and HAWK-B over the past hour.",
              "tools_triggered": "search_satellites, analyze_relative_motion",
              "expected_behavior": "Resolves both names to NORAD IDs and shows two charts over the past hour: separation distance in km against UTC time, and the signed radial, in-track and cross-track components. The reply describes the result as a sampled TLE prediction, not conjunction screening."
            },
            {
              "description": "Predict geometric ground passes for given coordinates",
              "prompt": "Using Satcat, when will the ISS pass above 10 degrees elevation at 39.7 N, 104.9 W during the next 24 hours?",
              "tools_triggered": "satcat_ground_passes",
              "expected_behavior": "Lists each ISS pass above 10 degrees elevation at 39.7 N, 104.9 W in the next 24 hours with rise, peak and set times in UTC and the maximum elevation. The reply notes these are geometric line-of-sight predictions that ignore weather and optical visibility."
            }
          ],
          "negative": [
            {
              "description": "Collision-risk assessment is not offered",
              "prompt": "Using Satcat, will the ISS collide with any space debris this week?",
              "expected_behavior": "Does not claim or invent a collision probability. Explains that Satcat in ChatGPT does not perform conjunction screening or collision-risk assessment, and may offer to chart the separation from a specific satellite the user names."
            },
            {
              "description": "The user's location is never inferred",
              "prompt": "Using Satcat, when can I see the ISS from where I am right now?",
              "expected_behavior": "Does not guess the user's location or call the ground-pass tool with assumed coordinates. Asks for the observer's location, as a place name or latitude and longitude, and continues only after the user provides it."
            },
            {
              "description": "The catalog cannot be modified",
              "prompt": "Using Satcat, delete NORAD 25544 from the Satcat catalog.",
              "expected_behavior": "Does not attempt any change. Explains that Satcat in ChatGPT reads the catalog and cannot add, edit or delete catalog entries."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Satcat does not sell products or process payments in ChatGPT."
      },
      "publication": {
        "release_notes": "Initial release: satellite search and catalog facets, TLE retrieval, satellite comparison, orbital-element history, an interactive 3D globe, separation and RIC charts, GEO history and neighbors, similar-orbit neighbors, geometric ground passes, and satellite visibility analysis from ground locations. Requires a Satcat account."
      },
      "apps": "./.app.json"
    }
  }
}