GoVisit Toolkit

GoVisit Toolkit

[

GoVisit is a travel platform that helps people and AI agentsdiscover destinations, local businesses, and experiences. It brings togetherpublished destination and business profiles so travelers can explore what placesoffer and local businesses can make their services easier to find and understand.

Tools and resources for using GoVisit with AI agents andcoding assistants, including Claude Code, Codex, GitHub Copilot, Cursor, and otherAgent Skills-compatible tools.

This repository contains open-source tools, 22 portable read skills, nativeClaude Code/Codex packages, release tooling, and implementation resources for GoVisit.The website documentationexplains each tool's inputs and interpretation limits.

Open-source tools

Each tool has its own dependencies, build, and deployment instructions. Seetools/README.md for the directory conventions. Agent skills andnative plugins below are installed separately from these applications.

Choose a package

Audience packages overlap: the same canonical reader can be useful to a travel planner, a destination manager, and a local business. Choose All or any audience package you need. The current release reads publicinformation without a GoVisit API key; it does not include editing workflows.An AI host may still request network/tool permission. Service limits and theData Use License apply, and model usage follows your assistant's plan.

Install portable skills

For a three-step setup with one choice of AI assistant, follow theInstallation guide.Install once, then use any included skill.

The npx skills installer requires Node.js 22.20 or later and npm. Its GitHubshorthand commands use the repository's default branch, main.

Run in your project and choose the target agent and installation scope:

npx skills add inhotel-io/govisit-toolkit --skill '*'

The portable skills are the shared route for compatible AI tools. For anexplicit target, install all 22 skills for GitHub Copilot or Cursor:

npx skills add inhotel-io/govisit-toolkit --skill '*' --agent github-copilot
npx skills add inhotel-io/govisit-toolkit --skill '*' --agent cursor

Install the matching CLI before using those assistants from a terminal.

GitHub Copilot CLI (Node.js 22 or later):

npm install -g @github/copilot

Start it with copilot; on first launch, sign in with /login. Runcopilot update to update it. GitHub also documents Homebrew, WinGet, and aninstall script in its Copilot CLI installation guide.

Cursor CLI (macOS, Linux, or Windows Subsystem for Linux):

curl https://cursor.com/install -fsS | bash
agent --version

On native Windows, run irm 'https://cursor.com/install?win32=true' | iex inPowerShell. Cursor updates automatically; run agent update to update itmanually. See Cursor CLI installation.

Choose the command for your assistant; you do not need to install twice. SeeGitHub's skills guideand Cursor's skills guide for discovery and scope.The installer currently uses the shared project directory .agents/skills/ forboth targets; their host-specific directories .github/skills/ and.cursor/skills/ are also options for manual installation.

For another AI tool, select it in the interactive installer or install completeskill directories in its documented Agent Skills location. The host must loadSKILL.md and its references/contract.json, and have permission to make HTTPSrequests to GoVisit. Model choice alone does not provide those capabilities.See the compatibility and verification record for thedifference between installation checks and an exercised model conversation.

For a single skill and an explicit target:

npx skills add inhotel-io/govisit-toolkit --skill govisit-search-places --agent codex

The canonical files live under skills/govisit-*/. Names already includegovisit-; keep the directory and SKILL.md name together without rewriting them.Manual downloads use the discovery index,which points to versioned release assets and their SHA-256 digests. Verify theoriginal archive bytes before unpacking the complete package, including LICENSEand references. A collection archive is not a universally supported skill-upload format.

Install native plugins

Claude Code:

Install the Claude Code CLI first. Anthropic recommends the native installer for macOS, Linux, and WSL:

curl -fsSL https://claude.ai/install.sh | bash
claude --version

On Windows, use the official Claude Code installation guide for the PowerShell or Command Prompt installer. Then add the marketplace and install a plugin:

claude plugin marketplace add inhotel-io/govisit-toolkit
claude plugin install govisit-travel-planner@govisit-toolkit --scope project

The marketplace command uses the repository's default main branch.

Codex:

Install or upgrade Codex CLI with Node.js and npm before running these commands:

npm install -g @openai/codex@latest

codex plugin marketplace add inhotel-io/govisit-toolkit --ref main
codex plugin add govisit-travel-planner@govisit-toolkit

Use govisit@govisit-toolkit for All, govisit-destination@govisit-toolkit for Destination, or govisit-local-business@govisit-toolkit for Local Business. Native packages live underplugins/; their included skill files are generated from the canonical skills/selection, and all resources remain inside the plugin root. A native Claude skillis namespaced, for example /govisit-travel-planner:govisit-search-places; portableskill invocation uses the host's own skill selector.

Codex reads each package's listing and composer icons from its plugin.json; theSVGs live in that package's assets/ directory. The Codex marketplace manifestcurrently has no marketplace-level icon field. Its GoVisit Toolkit brand SVG iskept at plugins/assets/marketplace.svg for use by surfaces that support one.

For destination and local business managers

Start by finding your own published entry. A destination manager can usegovisit-search-destinations, then govisit-get-destination-overview andgovisit-get-destination-section. A local business manager can usegovisit-search-places, then govisit-get-place-overview,govisit-get-place-section, and govisit-get-place-visit-facts.

These skills are already included in the corresponding audience package and canalso be installed individually. The same readers are reused across audiences.The planned govisit-update-destination and govisit-update-place skills willjoin those packages when their secure authoring workflows are implemented. Readinga public profile does not establish ownership or grant permission to update it.

First task

After installation, start a session if your host needs to refresh discovery:

Search GoVisit for places in Czechia where travelers can actively participate in immersive experiences such as regional festivals, traditional craft workshops, historical preservation sites, and local food traditions.Read the published profiles, explain missing evidence, and link the GoVisit sources.

An empty result does not prove absence, and published discovery facts do not provelive prices or availability. The example performs reads and makes no reservation.

Updates and diagnostics

To move a Codex marketplace from a version tag to the current GoVisit source,remove and re-add it at main, then install the selected package again. Existingplugin snapshots are updated by the final command:

codex plugin marketplace remove govisit-toolkit
codex plugin marketplace add inhotel-io/govisit-toolkit --ref main
codex plugin add govisit-travel-planner@govisit-toolkit

Use your audience package name in the last command. Re-adding an existingmarketplace with a different --ref requires removing its old marketplacedeclaration first. main tracks ongoing changes; use a reviewed release tagwhen a stable, reproducible version is required.

Installed copies are snapshots. For portable skills, use npx skills check andnpx skills update, or reinstall the selected complete package through yourinstaller. Native users update the marketplace/plugin using their client'ssupported commands. Pin a reviewed release/commit for reproducible automation;GitHub Release archives are versioned, while a checkout of main can change.

Remove portable skills through npx skills remove; native users useclaude plugin uninstall or codex plugin remove with the installed package ID.Confirm actual installed paths/versions in your client before removing anything.

If a task fails, check the package version, network access to GitHub releaseassets and govisit.ai, required arguments, and the response's error/freshnessmetadata. HTTP 429 requires respecting Retry-After. Never paste credentials orprivate business/travel data into a public issue.

For maintainers, see release preparation and verification.

Licensing

The GoVisit Toolkit's code, skills, scripts, schemas, documentation, and examplesare licensed under the MIT License unless otherwise indicated.You can reuse, modify, redistribute, and commercially use these materials underthat license. Preserve the required copyright and license notice when doing so.

Access to GoVisit-hosted search, public read APIs, WebMCP tools, and use ofreturned GoVisit Data are governed separately by theGoVisit Data Use License.The toolkit license grants no additional service capacity, data rights, or editingpermissions. Third-party materials retain their identified licenses and notices.

These are separate scopes. The Data Use License is not an additional restrictionon reuse of the MIT-licensed toolkit files. Conversely, including a client orschema here does not make the hosted service or its returned data MIT-licensed.

See Hosted services and data terms for the scope of each setof terms, attribution guidance, and handling of examples and submissions.

Responsible use

• Follow the documented interfaces, request limits, and any account-specificaccess conditions. Installing a skill does not grant backend permissions.
• Preserve data attribution, provenance, freshness, and source-license noticeswhen using GoVisit responses, as required by the applicable terms.
• Use clearly labeled synthetic data in examples where possible. Identify thesource and applicable terms for any separately licensed fixtures or media.
• Keep credentials, personal information, and confidential business data out ofpublic issues, examples, and pull requests.