← Back to Skills Marketplace
projectsnowwork

logic

by ProjectSnowWork · GitHub ↗ · v1.0.2 · MIT-0
linuxdarwinwin32 ✓ Security Clean
439
Downloads
0
Stars
2
Active Installs
3
Versions
Install in OpenClaw
/install logic
Description
Start from what must be true. Stop answering on autopilot.
README (SKILL.md)

Logic — Think from Structure

Start from what must be true. Stop answering on autopilot.

Why This Skill Exists

The biggest problem with most agents is not lack of knowledge.

It is path dependence.

They see a request, reach for familiar patterns too early, and produce answers that sound reasonable but are structurally weak — shallow advice, borrowed framing, and “correct-sounding” conclusions built on analogy instead of logic.

This skill changes the default move.

It installs a logic gate before the answer:

reduce before responding.

Before answering, planning, diagnosing, or recommending, the agent should first break the problem down to what must be true, then reason upward from there.

What It Installs

This skill installs a structural reasoning system that helps the agent:

  • strip away surface framing and recover the real objective
  • separate hard constraints from breakable convention
  • find the load-bearing variables that actually decide the outcome
  • explain through mechanism, not mimicry
  • expose the most fragile assumption behind a conclusion
  • clarify messy problems before giving recommendations
  • improve over time through reflections, candidate rules, and worked cases

When to Use

Use this skill when:

  • the request is ambiguous or underspecified
  • the task involves strategy, tradeoffs, diagnosis, or judgment
  • the visible symptom may not be the real cause
  • common advice is likely to be shallow or misleading
  • the cost of a weak answer is meaningful
  • the user needs a decision structure, not just information

Quick Examples

  • “Should I use React or Vue for this project?” A shallow answer compares features. Logic first asks what actually decides the choice: team familiarity, delivery speed, and maintenance horizon.

  • “Why is this product not growing?” A shallow answer suggests better marketing. Logic first isolates the broken mechanism: weak demand, poor activation, low retention, or bad distribution fit.

  • “Should I enter this market?” A shallow answer looks at market size. Logic first checks edge, constraints, downside, and what would actually create asymmetry.

Core Behavior

The agent should not begin with a conclusion.

It should first identify:

  1. the real objective
  2. the governing constraints
  3. the load-bearing variables
  4. the key assumptions
  5. the mechanism that connects facts to action
  6. the assumption most likely to break the conclusion

If the problem is messy, return a cleaned structure before returning a recommendation.

Architecture

Memory and reasoning files live in ~/logic/. If the directory does not exist, initialize it using setup.md.

~/logic/
├── principles.md       # HOT: reasoning constitution, always loaded
├── patterns.md         # reusable decomposition scaffolds
├── reflections.md      # lessons from strong / weak reasoning runs
├── candidates.md       # candidate rules before promotion
├── heartbeat-state.md  # maintenance markers
├── index.md            # file map and counts
└── cases/              # worked examples by domain
Usage Guidance
This skill is instruction-only and appears coherent with its stated goal: it will create and maintain a small workspace at ~/logic/ and write plain-text files (principles, patterns, cases, heartbeat state). Before installing, decide whether you are comfortable with a skill creating ~/logic/ and updating heartbeat-state.md. Optionally inspect the bundled files (principles.md, heartbeat-rules.md, setup.md) to confirm content matches your expectations. Note: metadata lists optional config paths like ./AGENTS.md and ./SOUL.md — these are not required by the skill but, if present in your environment, you should check their contents because the skill’s metadata references them. No credentials, external downloads, or network endpoints are requested by the skill.
Capability Analysis
Type: OpenClaw Skill Name: logic Version: 1.0.2 The 'Logic' skill bundle is a structured reasoning framework designed to improve agent decision-making through problem reduction and mechanism-based analysis. It establishes a local workspace in `~/logic/` (via `setup.md`) to store principles, patterns, and reflections, using a 'heartbeat' mechanism (`heartbeat-rules.md`) for maintenance. There is no evidence of data exfiltration, malicious execution, or prompt injection intended to bypass security controls; all instructions are aligned with the stated goal of enhancing logical reasoning.
Capability Assessment
Purpose & Capability
The name and description promise structural reasoning support; the skill is instruction-only and provides patterns, principles, and a small local workspace (~/logic/) for cases, candidates, and heartbeat state. Nothing required (no env vars, no binaries, no network downloads) appears disproportionate to this purpose.
Instruction Scope
Runtime instructions focus on initializing and reading/writing files under ~/logic/, maintaining heartbeat-state.md, and returning structured reductions before answering. The only file operations are confined to the declared workspace; the skill does not instruct the agent to read unrelated system files, environment variables, or send data to external endpoints. It does reference optional configPaths (./AGENTS.md, ./SOUL.md, ./HEARTBEAT.md) in metadata—these are not actively used in the instructions but you should review them if they exist in your environment.
Install Mechanism
No install spec and no code files that would be downloaded or executed. This is low-risk: nothing is written outside the declared workspace except the suggested ~/logic/ directory and files within it.
Credentials
The skill requires no environment variables, credentials, or external config paths. The declared configPaths target only a local workspace (~/logic/) and some optional local filenames; these are proportionate to a reasoning/memory aid.
Persistence & Privilege
The skill persists state in ~/logic/ (creates files such as principles.md, heartbeat-state.md, candidates.md, reflections.md). This is intended behavior for a reasoning workspace. It is not always: true and does not request elevated privileges, but installing it will create and update files in your home directory; review those files if you are concerned about local disk writes.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install logic
  3. After installation, invoke the skill by name or use /logic
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Strengthened the front-page language and positioning for greater clarity and force. - Sharpened the core promise: always reduce problems to what must be true before answering. - Added clear framing around avoiding shallow, autopilot answers; now emphasizes installing a logic gate before responding. - Included practical examples illustrating structural reasoning in action. - Improved language and logic-gate framing throughout the documentation.
v1.0.1
- Refined positioning and language throughout the documentation for improved clarity. - Sharpened the core promise: the agent now focuses on breaking problems down to underlying truths before answering. - Updated description and messaging to better communicate the skill’s purpose and usage.
v1.0.0
Initial release of Logic — Think from Structure: - Adds a structural reasoning system that enforces objective, constraint, mechanism, and core driver analysis before responding. - Includes reasoning principles, decomposition patterns, worked cases, reflection logs, candidate rules, and heartbeat maintenance. - Helps clarify messy or underspecified problems and improves answer quality where shallow responses are risky.
Metadata
Slug logic
Version 1.0.2
License MIT-0
All-time Installs 2
Active Installs 2
Total Versions 3
Frequently Asked Questions

What is logic?

Start from what must be true. Stop answering on autopilot. It is an AI Agent Skill for Claude Code / OpenClaw, with 439 downloads so far.

How do I install logic?

Run "/install logic" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is logic free?

Yes, logic is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does logic support?

logic is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux, darwin, win32).

Who created logic?

It is built and maintained by ProjectSnowWork (@projectsnowwork); the current version is v1.0.2.

💬 Comments