countries

What This Skill Does

The Countries skill provides OpenClaw AI agents with direct, real-time access to global geographical and demographic data. By wrapping the REST Countries API (v3.1), this skill transforms an agent into a knowledgeable geopolitical assistant capable of fetching detailed country profiles, capital cities, regional demographics, and cultural metadata. It eliminates the need for agents to hallucinate facts or rely on potentially outdated training data by performing live queries against a reliable, open-source database. Whether the user needs the population of a specific country, a list of nations in a particular region, or details on currency and time zones, this skill acts as a seamless bridge between the user's inquiry and factual global information.

Installation

To install this skill, use the clawhub command in your OpenClaw environment:

clawhub install openclaw/skills/skills/jeffaf/countries

Ensure that your shell has access to the scripts/countries dependency path to allow the AI agent to trigger the underlying CLI tool correctly.

Use Cases

• Research & Analysis: Agents can quickly compile lists of countries within a specific region for regional economic analysis.
• Geopolitical Education: Students and curious users can ask conversational questions about capital cities, official languages, or driving conventions (left vs right).
• Reference Lookup: Quickly resolve country codes (alpha-2, alpha-3, or numeric) for administrative or technical tasks.
• Data Enrichment: Agents can use this data to provide context to other tasks, such as populating location data in forms or summarizing geopolitical news.

Example Prompts

1. "I'm planning a trip to Asia, can you list all the countries in the Asia region for me?"
2. "What is the capital of Mongolia and what is the official currency used there?"
3. "Tell me everything you know about Brazil including its population, languages, and time zone."

Tips & Limitations

• Regional Queries: Always use lowercase for region names (e.g., 'europe', 'africa') to ensure the CLI interprets the request correctly.
• Precision: If searching by capital city, provide the exact name. If the query returns multiple results, consider refining your search with the full country name.
• Limitations: Note that this skill is strictly for sovereign nations. It does not provide data on disputed territories, historical empires that no longer exist, or non-sovereign administrative regions (e.g., overseas territories not explicitly recognized as countries by the API).
• Performance: Since this uses the REST Countries API, there is no need for authentication or API keys, ensuring zero friction during installation and setup. Responses are formatted for human readability but can be parsed if you are extending the agent's logic to handle structured output.