A specialized CLI tool that allows AI agents to fetch comprehensive geographical and demographic data for any country using the REST Countries API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install countries
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install countries using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Countries Lookup?
The Countries Lookup skill is a robust utility designed for AI agents operating within Openclaw Skills environments. It provides a seamless interface to the REST Countries API (v3.1), enabling agents to retrieve detailed information such as capital cities, population statistics, currencies, and official languages without requiring any authentication or API keys.
By integrating this skill, developers can enhance their agents' ability to handle geographic queries with high precision. The tool handles the complexity of API requests and data parsing, delivering a structured, human-readable format that agents can easily interpret and present to users. Whether it is looking up a country by its alpha code or listing all nations in a specific region, this skill acts as a reliable reference layer for any geo-aware AI application.
Countries Lookup Use Cases
- Identifying country details such as population, area, and timezones from a simple search query.
- Finding a country based on its capital city or alpha-2/alpha-3 country codes.
- Generating lists of countries within specific geographic regions like Asia, Europe, or the Americas.
- Providing AI agents with technical data for travel, logistics, or educational research tasks.
How Countries Lookup Works
- The AI agent identifies a geographic query and invokes the countries command with a specific action (search, info, or region).
- The skill script uses curl to request data from the REST Countries API v3.1.
- The raw JSON response is processed through jq and bc to format numerical data, such as population, into readable suffixes (K, M, B).
- The formatted text, including metadata like maps and flag emojis, is returned to the agent.
- The agent uses this information to formulate a detailed response for the human user.
Countries Lookup Setup
To use this skill within your Openclaw Skills setup, ensure the following system dependencies are installed:
sudo apt-get update
sudo apt-get install curl jq bc
The script is located at {skill_folder}/countries. Ensure it has execution permissions:
chmod +x ./countries
Countries Lookup Data Schema & Taxonomy
The skill organizes geographical data into a structured format suitable for LLM consumption. Below is the primary data mapping:
| Field | Format | Description |
|---|---|---|
| Code | Alpha-2 / Alpha-3 | International country codes (e.g., US, USA) |
| Population | Number (Suffix) | Formatted population count (e.g., 331M) |
| Region | String | Major geographic region and sub-region |
| Map | URL | Direct link to Google Maps for the location |
| Flags | Emoji | Unicode flag representation |
Countries Lookup Advanced Features
- Support for multiple country identifiers including Alpha-2, Alpha-3, and Numeric (ISO 3166-1) codes.
- Automated regional filtering to fetch all countries within a specific continent or territory.
- High-performance capital city reverse lookup to identify countries by their administrative centers.
- Pre-formatted population scaling for immediate display without additional agent-side calculations.
SKILL.md
Loading
Related Openclaw Skills
Council of the Wise
A sophisticated decision-support tool that spawns a panel of expert sub-agents to provide diverse feedback and a synthesized verdict on your ideas.
Brewery Lookup
A lightweight CLI tool for AI agents to locate and identify breweries across the globe using the Open Brewery DB.
Book Lookup
A CLI-based skill for AI agents to search and retrieve comprehensive book and author data using the Open Library API.
Anime Lookup
A robust CLI tool for AI agents to retrieve detailed anime metadata, seasonal charts, and rankings from MyAnimeList without authentication.
Harry Potter Lookup
A CLI tool enabling AI agents to query the Harry Potter universe for character details, spells, and Hogwarts house information via the HP-API.
Pokemon Lookup
A CLI-based tool for AI agents to retrieve detailed Pokémon data including types, stats, and abilities via PokéAPI.
Featured*
