How do I install the Agentos skill?

Run npx skillmds@latest add fikriaf/agentos-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Agentos safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Agentos?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Agentos free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Agentos?

fikriaf (@fikriaf) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Agentos by fikriaf — Agent Skill

Name: Agentos
Author: fikriaf

File contents

AgentOS (fikriaf/agentos)

Autonomous AI agent framework from https://github.com/fikriaf/agentos

Installation

git clone https://github.com/fikriaf/agentos.git /opt/agentos
cd /opt/agentos
pip install -e .

Requirements

Python 3.10+
OpenAI API key (or compatible)
Skills in ~/.hermes/skills/

Configuration

Set environment variable:

export OPENAI_API_KEY="sk-..."

Or use config file at ~/.agentos/config.yaml:

llm:
  provider: "openai"
  model: "gpt-4"
  api_key: "${OPENAI_API_KEY}"

Commands

# Run task (auto mode)
agentos run "Build a REST API for todo list"

# Interactive wizard mode
agentos wizard

# Session management
agentos sessions          # List sessions
agentos resume --session session_id
agentos delete --session session_id

# Info
agentos info

Quick mode with auto-confirm:

agentos run "Write tests" --auto-confirm

Architecture

User Input → Context Engineering → ROMA Planner → HTAA Executor → MOSAIC Safety → Memory → Reflection

Components

ROMA Planner - Recursive task decomposition into parallel subtasks
HTAA Executor - Tool grouping for reduced action space
MOSAIC Safety - Plan → Check → Act/Refuse safety pipeline
Memory - File-based state externalization (InfiAgent)
Skills - 93 built-in skills loaded on demand

Key Files

src/agentos/cli.py - Main CLI entry point
src/agentos/agents/planner.py - ROMA planner implementation
src/agentos/agents/executor.py - HTAA executor with tool grouping
src/agentos/skills/__init__.py - SkillsManager loader
SPEC.md - Full technical specification

Skills Integration

Copy existing skills to AgentOS:

cp -r ~/.hermes/skills/* /opt/agentos/src/agentos/skills/
cd /opt/agentos && pip install -e .

AgentOS loads skills via skill_view(name) for context.

Known Issues

Issue	Solution
Safety blocks startup	Use `--auto-confirm` flag
Python tool fails	Use `python3` not `python` in commands

Troubleshooting

# Debug mode
agentos run "task" --verbose

# Check version
agentos --version

# Show config
agentos info

Links

GitHub: https://github.com/fikriaf/agentos
Releases: https://github.com/fikriaf/agentos/releases
Author: fikriaf

---name: agentos-2description: AgentOS from fikriaf/agentos - Autonomous AI agent framework with ROMA planning, HTAA tool grouping, MOSAIC safety. Use for complex task automation.---# AgentOS (fikriaf/agentos)Autonomous AI agent framework from https://github.com/fikriaf/agentos## Installation```bashgit clone https://github.com/fikriaf/agentos.git /opt/agentoscd /opt/agentospip install -e .```## Requirements- Python 3.10+- OpenAI API key (or compatible)- Skills in `~/.hermes/skills/`## ConfigurationSet environment variable:```bashexport OPENAI_API_KEY="sk-..."```Or use config file at `~/.agentos/config.yaml`:```yamlllm: provider: "openai" model: "gpt-4" api_key: "${OPENAI_API_KEY}"```## Commands```bash# Run task (auto mode)agentos run "Build a REST API for todo list"# Interactive wizard modeagentos wizard# Session managementagentos sessions # List sessionsagentos resume --session session_idagentos delete --session session_id# Infoagentos info```Quick mode with auto-confirm:```bashagentos run "Write tests" --auto-confirm```## Architecture```User Input → Context Engineering → ROMA Planner → HTAA Executor → MOSAIC Safety → Memory → Reflection```### Components1. **ROMA Planner** - Recursive task decomposition into parallel subtasks2. **HTAA Executor** - Tool grouping for reduced action space3. **MOSAIC Safety** - Plan → Check → Act/Refuse safety pipeline4. **Memory** - File-based state externalization (InfiAgent)5. **Skills** - 93 built-in skills loaded on demand## Key Files- `src/agentos/cli.py` - Main CLI entry point- `src/agentos/agents/planner.py` - ROMA planner implementation- `src/agentos/agents/executor.py` - HTAA executor with tool grouping- `src/agentos/skills/__init__.py` - SkillsManager loader- `SPEC.md` - Full technical specification## Skills IntegrationCopy existing skills to AgentOS:```bashcp -r ~/.hermes/skills/* /opt/agentos/src/agentos/skills/cd /opt/agentos && pip install -e .```AgentOS loads skills via `skill_view(name)` for context.## Known Issues| Issue | Solution ||-------|----------|| Safety blocks startup | Use `--auto-confirm` flag || Python tool fails | Use `python3` not `python` in commands |## Troubleshooting```bash# Debug modeagentos run "task" --verbose# Check versionagentos --version# Show configagentos info```## Links- GitHub: https://github.com/fikriaf/agentos- Releases: https://github.com/fikriaf/agentos/releases- Author: fikriaf

Frequently asked questions

Agentos