← Back to Skills Marketplace
Principles Agent
by
lingxinsuixing
· GitHub ↗
· v0.2.0
· MIT-0
123
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install principles-agent
Description
基于第一性原理思维的迭代式 Agent,拆解复杂目标为原子任务,自动验证调试并依赖感知执行保证最终交付质量。
Usage Guidance
This skill appears coherent and consistent with its description: it orchestrates decomposition and delegates LLM calls to the host. Before installing, note: (1) run it inside OpenClaw or provide a proper llm_call function — the CLI will raise if llm_call isn't injected; (2) the code contains some minor implementation issues (some methods build prompts then parse the prompt as if it were an LLM response), which are likely bugs rather than malicious behavior; (3) the skill writes a report only when you pass --output (so be cautious about the output path you provide). If you plan to run this in production, review the code for robustness around JSON extraction and error handling and test it in a sandboxed OpenClaw session first.
Capability Analysis
Type: OpenClaw Skill
Name: principles-agent
Version: 0.2.0
The principles-agent skill is a legitimate implementation of a task-decomposition framework based on first-principles thinking. The code (orchestrator.py, executor.py, etc.) focuses entirely on logic flow, iterative refinement, and topological sorting of tasks, relying on the host environment to provide LLM access. It adheres to its stated permission boundaries, containing no network requests, environment variable access, or unauthorized file system operations. The internal prompts used for the AI agent are strictly aligned with the framework's purpose and do not contain malicious instructions or injection attempts.
Capability Assessment
Purpose & Capability
Name/description match the code: modules implement goal clarification, truth derivation, task breaking, refinement, dependency sorting, execution via an injected llm_call, validation, and integration. The skill declares no external credentials or network use, which aligns with the implementation that expects an injected llm_call from the OpenClaw host.
Instruction Scope
SKILL.md states the skill never calls network or reads environment variables; the code follows that pattern by expecting an injected llm_call and not performing outbound requests or reading env vars. Minor implementation inconsistencies: cli.py expects a global 'llm_call' (will raise if run outside an OpenClaw session), and some library methods expose APIs that build prompts and then call the local _parse_response on the prompt (i.e., parse the prompt as though it were an LLM response) — these are likely bugs but not malicious behavior. The skill writes files only when the user supplies --output.
Install Mechanism
No install spec provided (instruction-only install), and there are no downloads or package installs. The skill ships source files but does not declare or perform any network-based installation — low install risk.
Credentials
The skill requires no environment variables, no credentials, and no config paths. All LLM access is expected to be provided by the host via a callable 'llm_call'. This is proportionate to the stated orchestration purpose.
Persistence & Privilege
The skill does not request persistent or elevated privileges (always: false). It does not modify system configuration or other skills. File writes are user-initiated via --output only.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install principles-agent - After installation, invoke the skill by name or use
/principles-agent - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.0
**principles-agent 0.2.0 — 架构更新,权限边界细化**
- 明确分离 skill 与主 Agent 职责,skill 仅负责任务规划与验证,主 Agent 负责所有实际操作与 LLM 调用
- 新增权限边界声明:skill 不直接访问网络、不读环境变量、不主动写文件,全部 IO 由主 Agent 托管
- 工作流程和架构目录细化,增强分层质量验证和依赖识别逻辑
- 文档更侧重安全与最小权限原则,提升透明度
v0.1.0
- Initial release of principles-agent: an iterative agent framework based on first principles thinking.
- Provides atomic-level task decomposition, iterative refinement, dependency-aware scheduling, and multi-level validation.
- Integrates with OpenClaw and leverages its built-in LLM for processing.
- CLI interface supports task execution, file output, and max iteration configuration.
- Suitable for complex system design, deep problem analysis, and multi-agent scenarios.
Metadata
Frequently Asked Questions
What is Principles Agent?
基于第一性原理思维的迭代式 Agent,拆解复杂目标为原子任务,自动验证调试并依赖感知执行保证最终交付质量。 It is an AI Agent Skill for Claude Code / OpenClaw, with 123 downloads so far.
How do I install Principles Agent?
Run "/install principles-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Principles Agent free?
Yes, Principles Agent is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Principles Agent support?
Principles Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Principles Agent?
It is built and maintained by lingxinsuixing (@lingxinsuixing); the current version is v0.2.0.
More Skills