← Back to Skills Marketplace
Workspace Context Linter
by
lethehades
· GitHub ↗
· v1.0.0
· MIT-0
234
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install workspace-context-linter
Description
Diagnose always-loaded workspace context files such as AGENTS.md, SOUL.md, USER.md, MEMORY.md, and TOOLS.md. Use when you want to reduce context bloat, detec...
Usage Guidance
This skill appears to do what it says: a local Python linter that diagnoses always-loaded workspace markdown files. It does not request credentials or talk to external servers. Two precautionary points before you run it: (1) the provided script snippet appears to be truncated and contains at least one likely bug (an incomplete render/suggestions section and a probable undefined variable), so running it as-is may produce a crash — inspect the full scripts/context_linter.py file and fix/complete it before executing; (2) the linter reads files under the current working directory (and optionally memory/*.md or custom paths), so run it in a repository or folder that contains only files you are comfortable having inspected. If you want extra safety, open the full script and verify there are no network calls or exec/system calls (the visible code uses only standard library file reads and text analysis).
Capability Analysis
Type: OpenClaw Skill
Name: workspace-context-linter
Version: 1.0.0
The workspace-context-linter is a legitimate utility designed to analyze and optimize markdown context files. The core logic in scripts/context_linter.py is restricted to read-only file operations within the local workspace, performing keyword matching and structural analysis without any network calls, shell execution, or data exfiltration. The SKILL.md instructions are strictly aligned with the tool's diagnostic purpose and do not contain any prompt-injection attempts or unauthorized commands.
Capability Assessment
Purpose & Capability
The name/description match the observed behavior: the code and SKILL.md both load and analyze core workspace files (AGENTS.md, SOUL.md, USER.md, MEMORY.md, TOOLS.md) to detect duplicates, overweight sections, and misplaced content. The required resources (none) are proportionate to that purpose.
Instruction Scope
SKILL.md instructs the agent to read the included reference files and to run scripts/context_linter.py with a local scope. The script reads files from Path.cwd() and optionally memory/*.md or custom paths, which is coherent with the stated purpose but means the tool will read whatever files are present in the agent's working directory. That behavior is expected for a linter but you should be aware it will examine local workspace files (not remote endpoints).
Install Mechanism
There is no install spec (the skill is instruction + a Python script). No packages are downloaded or extracted and there are no external URLs invoked in the code. Running the skill requires executing the provided Python script locally.
Credentials
The skill requests no environment variables, no credentials, and no config paths. The script only reads local workspace files and has no network or secret-access code, so requested access is proportional to the purpose.
Persistence & Privilege
The skill is not always-loaded (always: false) and is user-invocable. It does not attempt to persist settings, modify other skills, or require elevated privileges. Autonomous invocation is allowed by default on the platform but that is not combined with other concerning attributes here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install workspace-context-linter - After installation, invoke the skill by name or use
/workspace-context-linter - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial public release of workspace-context-linter.
Metadata
Frequently Asked Questions
What is Workspace Context Linter?
Diagnose always-loaded workspace context files such as AGENTS.md, SOUL.md, USER.md, MEMORY.md, and TOOLS.md. Use when you want to reduce context bloat, detec... It is an AI Agent Skill for Claude Code / OpenClaw, with 234 downloads so far.
How do I install Workspace Context Linter?
Run "/install workspace-context-linter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Workspace Context Linter free?
Yes, Workspace Context Linter is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Workspace Context Linter support?
Workspace Context Linter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Workspace Context Linter?
It is built and maintained by lethehades (@lethehades); the current version is v1.0.0.
More Skills