Guide · Agent skill
How to use the System Info Inspector agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The System Info Inspector is an agent skill from the Agno cookbook that lets an AI agent run two small bundled Python scripts on the machine hosting an AgentOS process. It is useful when you want the agent to report the real host details and directory listings instead of guessing. This guide explains what the skill does, how to install it, how to trigger it, and what to watch for before enabling it.
System Info Inspectoragno-agi/agno · Apache-2.0 Download the skill Quick start
- 1Download and unzip. Download the system-info ZIP from this page and unzip it to get the system-info folder.
- 2Place the folder. Copy the folder to ~/.claude/skills/ for personal use or to a project's .claude/skills/ folder to scope it to that project.
- 3Or upload in the Claude apps. In the Claude apps, open Settings, go to Capabilities, then Skills, and upload the skill.
- 4Confirm requirements. Make sure the host has Python 3 and that your AgentOS setup can load skills and the get_skill_script tool.
- 5Ask a natural question. Ask about the host OS, Python version or a directory listing on the machine running AgentOS.
- 6Review the result. Check that the agent reports stdout data from a successful run, and treat any nonzero return code error as a failure.
What is an agent skill and what does this one do?
An agent skill is a folder containing a SKILL.md file with instructions, plus optional scripts the agent can run. The agent reads the instructions when a request matches the skill's purpose, then executes the bundled scripts and uses their output.
The system-info skill covers two tasks. The first, get_system_info.py, reports the hostname, operating system, architecture, Python version and executable, processor, and current UTC time. The second, list_directory.py, lists the direct children of a directory, defaulting to the skill directory if no path is given.
Install the System Info skill
Download the skill ZIP from this page and unzip it. For a personal setup, place the unzipped system-info folder in ~/.claude/skills/. To scope it to one project, place it in that project's .claude/skills/ folder.
You can also upload the skill in the Claude apps. Open Settings, go to Capabilities, then Skills, and upload the folder there.
- Personal: ~/.claude/skills/system-info/
- Project: .claude/skills/system-info/ inside your project
- Claude apps: Settings → Capabilities → Skills
Check the requirements
The skill needs Python 3 on the host, because the scripts use a python3 shebang. They rely only on the standard library, so there are no packages to install. You also need an Agno AgentOS setup that can load skills and the skill tool, specifically get_skill_script.
- Python 3 on the host machine
- An Agno AgentOS setup able to load skills
- The get_skill_script skill tool available to the agent
How to trigger the skill with natural requests
You do not need special syntax. Ask about the host running AgentOS or ask for a directory inventory from that host, and the agent should load the skill's instructions and choose the matching script.
The skill's instructions tell the agent to execute a script through the skill tool and inspect the structured result. Requests about the machine or its files are the ones it is written for.
- "What operating system and Python version is this AgentOS server running?"
- "Which machine is this agent running on, and what is its hostname?"
- "List the files and folders in the current directory on the host."
- "Show me what is in the ./data folder with file sizes."
get_skill_script(
skill_name="system-info",
script_path="get_system_info.py",
execute=True,
)Understand the directory listing call
When the agent lists a directory, it runs list_directory.py with a path argument. The skill's own example passes "." to list the current directory. Results come back as structured output, and the agent should only report data from stdout when the return code is 0.
If the return code is nonzero, the agent should report stderr or the JSON error rather than inferring a result. Treat that as the expected behaviour when checking a failed run.
get_skill_script(
skill_name="system-info",
script_path="list_directory.py",
execute=True,
args=["."],
)Safety notes before you enable it
The skill runs scripts on the machine hosting AgentOS and makes no network calls. The directory script can list any path it is given; it is not restricted to the skill folder. This means the agent can read file names and sizes anywhere the process has access.
The get_system_info script exposes the hostname, paths, and Python executable location to the agent and anyone who can see its replies. If that information is sensitive in your deployment, do not enable this skill.
This skill only reports basic facts. It was not written as a security or compliance audit tool.
- Runs scripts: yes. Uses network: no.
- Directory listing is not limited to the skill folder.
- Do not use it where hostname, paths or Python location must stay private.
Tips for getting reliable results
Be specific about the path you want listed. A clear request like "list ./logs" is easier for the agent to act on than a vague one. Use this skill to confirm which machine and Python version your AgentOS deployment runs on, which is especially handy when debugging a deployment.
The skill is also a readable example of how agent skills execute bundled scripts, so it is useful if you are learning the format.
- Name the directory explicitly when you want a specific listing.
- Use it to verify the host and Python version during deployment debugging.
- Read the scripts and SKILL.md to see how bundled execution works.
What people use it for
- Confirm which operating system, architecture and Python version an AgentOS deployment is running on while debugging.
- Get a quick inventory of a directory on the host, with file sizes, without logging in to the server.
- Check the current UTC time reported by the host machine.
- Learn how a skill's bundled scripts are executed through get_skill_script.
Frequently asked questions
How do I install the system-info agent skill?
Download the skill ZIP from this page and unzip it. Place the system-info folder in ~/.claude/skills/ for personal use or in a project's .claude/skills/ folder, or upload it in the Claude apps under Settings → Capabilities → Skills.
What does the system-info skill require?
It requires Python 3 on the host, since the scripts use a python3 shebang and only the standard library. You also need an Agno AgentOS setup that can load skills and the get_skill_script tool.
Is the system-info skill free?
The skill is licensed under Apache-2.0 according to the source repository listing. The SKILL.md file itself states an MIT license in its metadata, so check the licence files in the download before redistributing.
Does the system-info skill use the internet?
No. The skill is listed as not using the network. It runs two local Python scripts on the host machine.
Can the directory listing script read any folder?
Yes. The list_directory.py script accepts any path it is given and is not restricted to the skill folder, so only enable it where that level of file access is acceptable.
Is system-info a good security audit tool?
No. It only reports basic facts about the host and directory names and sizes. It was not written as a security or compliance audit tool.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use system-info if you are debugging an AgentOS deployment and want to confirm the host, operating system and Python version, or you want a quick directory inventory and a readable example of bundled skill scripts. Pick something else if you need restricted file access, privacy for hostnames and paths, or a real security or compliance audit.
Download the skill