← Back to Skills Marketplace
32
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install core-files-management
Description
Core Files Management for OpenClaw workspace agents. Use when: (1) managing or updating core Markdown files (identity.md, soul.md, agents.md, user.md, memory...
README (SKILL.md)
CORE FILES MANAGEMENT 📁
Universal management of OpenClaw core files
| Info | Value |
|---|---|
| Version | 1.1.0 — 2026-05-07 |
| Status | OPERATIONAL |
1. PURPOSE AND SCOPE
Objective
Manage the 6 core files + bootstrap.md in an OpenClaw workspace without duplication.
Universal Design
This skill works for ANY OpenClaw agent. Adapt language rules to your user's preferences.
When to Use
| Trigger | Action |
|---|---|
| Modify a core file | Check distribution rules |
| Verify organization | Read all core files |
| Avoid duplication | Use modification checklist |
| User asks about structure | Read this skill and give summary |
2. THE 6 CORE FILES
| # | File | Definition | Key Content |
|---|---|---|---|
| 1 | identity.md | Agent's "first impression" | Name, avatar, signature, functions, language architecture |
| 2 | soul.md | Agent's "heart" — personality & values | Essence, values, L7/L8 memory integration |
| 3 | agents.md | Logic & procedures manual | Specs, workspace rules, heartbeat, red lines |
| 4 | user.md | User context | User's info, preferences, infrastructure |
| 5 | memory.md | Long-term memory | Important events, key configs, workflows |
| 6 | tools.md | Technical configuration | Endpoints, hosts, commands, services |
Plus: bootstrap.md
| File | Definition | Purpose |
|---|---|---|
| bootstrap.md | Machine startup sequence | NOT soul — machine boot order only |
3. DISTRIBUTION RULES
| Content Type | Target File |
|---|---|
| Identity | identity.md |
| Personality/Values | soul.md |
| Operational Rules | agents.md |
| User Context | user.md |
| Persistent Facts | memory.md |
| Technical Config | tools.md |
| Startup Sequence | bootstrap.md |
Rule: Each file has ONE purpose. Don't mix content types.
Cluster Integration
| Component | Purpose | Location |
|---|---|---|
| identity.md | Agent's first impression | Workspace root |
| soul.md | Agent's heart | Workspace root |
| agents.md | Operational rules | Workspace root |
| cluster configuration | Agent connections | Workspace/cluster/ |
| skill storage | Published skills | workspace/skills/ |
4. LANGUAGE RULES
Adapt to your agent's context:
| Context | Language | Example |
|---|---|---|
| User communication | Agent's native language | "Bonjour!" / "Hello!" / "你好!" |
| Between agents | Chinese | "你好！很高兴与你交流" |
| Code/Technical | English | python3 script.py |
Rule: Every identity.md MUST state the user's communication language.
5. TOOLS
Required OpenClaw Tools
| Tool | Usage | Mode |
|---|---|---|
read |
Read core files | Required |
write |
Modify core files | Required |
edit |
Fix specific sections | Optional |
exec |
Verify file status, backup | Optional |
Verification Commands
# List core files
ls -la ~/.openclaw/workspace/*.md
# Check file content
head -20 ~/.openclaw/workspace/identity.md
# Backup before modification
cp ~/.openclaw/workspace/\x3Cfile>.md ~/.openclaw/workspace/\x3Cfile>.md.bak
# Count lines in all files
wc -l ~/.openclaw/workspace/*.md
# Verify file exists
test -f ~/.openclaw/workspace/identity.md && echo "exists"
# Count files
ls ~/.openclaw/workspace/*.md | wc -l
# Full file listing
find ~/.openclaw/workspace -maxdepth 1 -name "*.md" -type f
Required Permissions
| Permission | Purpose |
|---|---|
| Read workspace | Access core files |
| Write workspace | Modify core files |
| Exec (optional) | File operations, backups |
Backup & Restore
# Create backup
cp ~/.openclaw/workspace/identity.md ~/.openclaw/workspace/identity.md.backup
# Restore from backup
cp ~/.openclaw/workspace/identity.md.backup ~/.openclaw/workspace/identity.md
# List backups
ls ~/.openclaw/workspace/*.backup
6. MODIFICATION CHECKLIST
Before modifying any core file:
1. Which file does this content belong to?
→ Identity → identity.md
→ Personality/Values → soul.md
→ Operational Rules → agents.md
→ User → user.md
→ Persistent Facts → memory.md
→ Technical Config → tools.md
2. Is it already somewhere else?
→ Check all 6 core files
3. Are language rules clear?
→ User → their native language
→ Agents → Chinese
→ Code → English
4. Does it need backup?
→ YES → Backup first!
7. FILE PATHS
| File | Default Path |
|---|---|
| identity.md | ~/.openclaw/workspace/identity.md |
| soul.md | ~/.openclaw/workspace/soul.md |
| agents.md | ~/.openclaw/workspace/agents.md |
| user.md | ~/.openclaw/workspace/user.md |
| memory.md | ~/.openclaw/workspace/memory.md |
| tools.md | ~/.openclaw/workspace/tools.md |
| bootstrap.md | ~/.openclaw/workspace/bootstrap.md |
8. CONSTRAINTS
| Constraint | Description |
|---|---|
| No duplication | Workspace rules in agents.md only, not soul.md or identity.md |
| No mixing | tools.md is technical ONLY — no personality content |
| No bloating | memory.md does NOT contain full session logs |
| Backup first | Always backup before changing core files |
| One purpose per file | Don't mix content types |
9. ERROR HANDLING
Common Errors
| Error | Cause | Solution |
|---|---|---|
| Content in wrong place | Didn't check distribution rules | Re-read checklist, reassign |
| Duplication | Same content in multiple places | Merge, keep only one |
| Missing language | Didn't check language rules | Add user's native language |
| Data loss | Modification without backup | Restore from backup |
Security Issues
| Issue | Severity | Action |
|---|---|---|
| Overwriting without backup | HIGH | Always backup first |
| Wrong file modified | MEDIUM | Verify before write |
| Missing language rule | LOW | Add to identity.md |
10. EDGE CASES
| Case | Treatment |
|---|---|
| File missing | Create from scratch with correct format |
| File corrupted | Restore from backup or recreate |
| Massive duplication | Read all files, reorganize by type |
| New agent setup | Create all 6 core files + bootstrap.md |
| Path unclear | Use default ~/.openclaw/workspace/ |
11. USAGE COMMANDS
# List all core files
ls -la ~/.openclaw/workspace/*.md
# Check a specific file
head -20 ~/.openclaw/workspace/identity.md
# Backup before modification
cp ~/.openclaw/workspace/\x3Cfile>.md ~/.openclaw/workspace/\x3Cfile>.md.bak
# Count lines in all files
wc -l ~/.openclaw/workspace/*.md
12. TEMPLATE — Empty Core File
identity.md
# IDENTITY.md — [Agent Name]
> Identity = First impression
| Attribute | Value |
|-----------|-------|
| **Name** | [Your name] |
| **Signature** | [Your signature emoji] |
| **Role** | [Your role] |
## Language Rules
- User communication: [Native language]
- Between agents: Chinese
- Code/Technical: English
_In Altum Per [Your Principle]._
[Your name]
In Altum Per CoreFiles. 📁 Core Files Management v1.1
Usage Guidance
Install only if you want an agent to help manage OpenClaw core workspace files. Before allowing writes, ask for a diff or summary, make sure backups exist, and avoid storing passwords, tokens, or other secrets in user.md, memory.md, or tools.md.
Capability Analysis
Type: OpenClaw Skill
Name: core-files-management
Version: 1.1.0
The skill bundle provides a structured framework for managing an OpenClaw agent's core configuration files (e.g., identity.md, soul.md, tools.md). It includes standard shell commands for file operations like backups and verification within the ~/.openclaw/workspace/ directory and contains no indicators of data exfiltration, malicious execution, or unauthorized access.
Capability Assessment
Purpose & Capability
The stated purpose coherently matches the requested behavior: manage OpenClaw core Markdown files. It is still noteworthy because those files include identity, user context, long-term memory, technical configuration, and startup behavior.
Instruction Scope
Instructions are scoped to named Markdown files under the OpenClaw workspace and include a backup checklist, but they allow modifying persistent core files and do not explicitly require human approval before every edit.
Install Mechanism
No install spec, code files, required binaries, environment variables, or credentials are present. The static scan reported no suspicious patterns.
Credentials
The optional exec usage is limited to local file-status and backup commands such as ls, cp, wc, test, and find under ~/.openclaw/workspace, which is proportionate to the file-management purpose.
Persistence & Privilege
The skill can update persistent agent state files such as identity.md, agents.md, memory.md, tools.md, and bootstrap.md. This is disclosed and purpose-aligned, but users should review changes carefully.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install core-files-management - After installation, invoke the skill by name or use
/core-files-management - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
v1.1: Fully impersonal, universal. Dual evaluation (5-dim + ISO 25010). 100% structural score. 6 core files + bootstrap management.
v1.0.0
Universal core files management skill for any OpenClaw agent. English only, adaptable to any user's language preferences.
Metadata
Frequently Asked Questions
What is Core Files Management?
Core Files Management for OpenClaw workspace agents. Use when: (1) managing or updating core Markdown files (identity.md, soul.md, agents.md, user.md, memory... It is an AI Agent Skill for Claude Code / OpenClaw, with 32 downloads so far.
How do I install Core Files Management?
Run "/install core-files-management" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Core Files Management free?
Yes, Core Files Management is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Core Files Management support?
Core Files Management is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Core Files Management?
It is built and maintained by Kofna3369 (@kofna3369); the current version is v1.1.0.
More Skills