topos
Evaluate and improve code with Topos. Use for complexity reduction, security checks, refactor verification, and PLATINUM/GOLD goals. Skill: topos Owner: krv-labs Summary: Evaluate and improve code with Topos. Use for complexity reduction, security checks, refactor verification, and PLATINUM/GOLD goals. Tags: latest:1.0.16 Version history: v1.0.16 | 2026-10-10T11:59:37.827Z | auto - Bumped version to 0.9.0. - Removed the file skill-card.md. - Updated SKILL.md content for accuracy and alignment with current functionality. - No breaking changes to us
Rank
62
Safety
84
Downloads
1.4k
Updated
Oct 10, 2026
Version
1.0.16
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.4K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.0.16release · observed Oct 10, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s175s3223xzg0re6x5nrn7vra18ayje0:topos- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-krv-labs-topos/snapshot"
Documentation
CLAWHUB
143,930 characters of source documentation, loaded on request.
Extracted files
2 files captured from the source.
SKILL.md
---
name: topos
description: Evaluate and improve code with Topos. Use for complexity reduction, security checks, refactor verification, and PLATINUM/GOLD goals.
version: "0.9.0"
homepage: https://docs.krv.ai/topos/
metadata:
openclaw:
requires:
bins: [topos]
homepage: https://docs.krv.ai/topos/
os: [macos, linux]
emoji: "📐"
hermes:
tags: [code-quality, refactoring, security, metrics]
category: software-development
requires_toolsets: [terminal]
---
# Topos
Topos scores code on four pillars — **SIMPLE**, **COMPOSABLE**, **SECURE**, **NAVIGABLE** — and maps results to a medal lattice (SLOP → PLATINUM). Use it in a closed loop: measure, edit, re-measure.
## Use Case
Developers and AI coding agents use this skill to improve structural code quality, reduce complexity, verify refactors, and optimize toward PLATINUM or GOLD medals. It supports both CLI and MCP agent loops on local repositories.
**Deployment geography:** Global (local execution; no region-restricted services).
## When to Use
Load this skill when the user asks to improve code quality, reduce complexity, check structural security footguns, verify a refactor, or optimize toward PLATINUM/GOLD medals.
## Requirements / Dependencies
**Requires API Key or External Credential:** No
**Credential Type(s):** None
**Runtime dependencies:**
```bash
curl -fsSL https://docs.krv.ai/topos/install.sh | bash
npm install -g gitnexus # enables COMPOSABLE / PLATINUM scoring
```
- `topos` CLI on `PATH` (install via [docs.krv.ai/topos/install.sh](https://docs.krv.ai/topos/install.sh))
- Git repository for MCP baseline comparisons (`topos_assess_worktree_change`; untracked baselines via `topos_begin_refactor` → `topos_assess_snapshot`)
- `.gitnexus` dependency graph for COMPOSABLE / PLATINUM scoring (generated automatically when `gitnexus` is installed; force refresh with `topos depgraph generate` or `topos_generate_depgraph`)
COMPOSABLE is scored by default: `evaluate` / `inspect` and the MCP evaluate
tools detect a missing or stale `.gitnexus` and regenerate it before scoring.
Run `topos depgraph generate` only to force a refresh.
**Optional MCP setup** (for tool-based agents, not required for CLI-only use):
```bash
topos install --all # registers the MCP server in every supported harness
topos status # verify registration
```
Do not include secrets in prompts, logs, or output. Topos reads local source files and git state only; it does not transmit code to external services.
## Known Risks and Mitigations
Risk: The skill may guide agents to apply structural refactors that change behavior; Topos measures structure, not functional correctness.
Mitigation: Run project tests or linters after each edit; treat Topos verdicts as structural signals, not proof of correctness.
Risk: Agents may trust SECURE medal findings as full security assurance; Topos SECURE checks are structural heuristics, not full SAST.
Mitigation: Pair with dedicated securi_meta.json
{
"ownerId": "kn791q4c49jmw6xqwkwe3x1m6x8az9e7",
"slug": "topos",
"version": "1.0.16",
"publishedAt": 1791633577827
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/krv-labs/skills/topos",
"sourceUrl": "https://clawhub.ai/krv-labs/skills/topos",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T12:21:57.674Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-krv-labs-topos/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-krv-labs-topos/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T12:21:57.674Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.4K downloads",
"href": "https://clawhub.ai/krv-labs/topos",
"sourceUrl": "https://clawhub.ai/krv-labs/topos",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T12:21:57.674Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.16",
"href": "https://clawhub.ai/krv-labs/topos",
"sourceUrl": "https://clawhub.ai/krv-labs/topos",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-10T11:59:37.827Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-krv-labs-topos/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-krv-labs-topos/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.16",
"description": "- Bumped version to 0.9.0. - Removed the file skill-card.md. - Updated SKILL.md content for accuracy and alignment with current functionality. - No breaking changes to usage or dependencies.",
"href": "https://clawhub.ai/krv-labs/topos",
"sourceUrl": "https://clawhub.ai/krv-labs/topos",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-10T11:59:37.827Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
