agentleFS
noah-1106noah-1106/Skills_Repo/skills/ec_creator/SKILL.md

ec_creator

Skill32 starsChanged 6 days agoMITView on GitHub

Execution Card Linter & Validator with Auto-Fix | 执行卡片检查与自动修复工具 A validation and correction tool for creating standardized Execution Cards. | 创建标准化执行卡片的验证和修正工具

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Must have these Markdown H2 sections: | 必须包含以下Markdown H2章节:

    line 123
  2. Distinctive:

    All paths must be: | 所有路径必须:

    line 141
  3. Distinctive:

    Every external tool/skill must be listed in Resource Dependencies | 每个外部工具/技能必须在资源依赖中列出

    line 148
  4. Distinctive:

    Must have at least one of: | 必须至少包含以下之一:

    line 152

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

EC Creator Skill | EC 创建技能

Version: 1.1.0 | Execution Card Linter & Validator with Auto-Fix | 执行卡片检查与自动修复工具

A validation and correction tool for creating standardized Execution Cards. | 创建标准化执行卡片的验证和修正工具。


What's New in v1.1.0 | v1.1.0 新特性

  • Python-based: Data-driven validation using JSON rules (no hard-coding) | 使用JSON规则的数据驱动验证(无硬编码)
  • Auto-Fix Suggestions: Returns copy-pasteable Markdown snippets for common issues | 返回可复制的Markdown片段用于常见问题
  • Real Skill Scanning: Actually checks ~/.openclaw/skills/ directory for skill existence | 实际检查 ~/.openclaw/skills/ 目录中的技能存在性
  • Enhanced Error Messages: More actionable guidance | 更具操作性的指导

What This Skill Does | 此技能功能

EC Creator transforms draft workflow descriptions into production-ready Execution Cards through automated validation and iterative correction. | EC Creator 通过自动化验证和迭代修正,将工作流草稿转换为生产就绪的执行卡片。

Core Workflow / 核心工作流:

Draft (temp_draft.md) → Lint → Fix → Validate → Standard EC (EC-XXX.md)
草稿 (temp_draft.md) → 检查 → 修复 → 验证 → 标准 EC (EC-XXX.md)

Core Functions | 核心功能

1. Structure Integrity Scan | 结构完整性扫描

Validates logical blocks are complete: | 验证逻辑块是否完整:

Block / 模块Check / 检查Error if Missing / 缺失时错误
Resource Dependencies / 资源依赖Lists required skills/tools"Agent may hallucinate unavailable tools" / "Agent可能幻觉不存在的工具"
Execution Workflow / 执行工作流Numbered step list"Non-sequential, hard to parse" / "非顺序,难以解析"
Execution Conventions / 执行约定I/O paths defined"Cross-agent collaboration fails" / "跨Agent协作失败"

2. Path Vitality Check | 路径活力检查

Scans and validates all paths in the EC: | 扫描并验证EC中的所有路径:

# Checks / 检查:
- Resource paths: Do files exist? / 资源路径:文件是否存在?
- Output directories: Are they writable? / 输出目录:是否可写?
- Template references: Are they valid? / 模板引用:是否有效?

# Example Output / 示例输出:
[FAIL] Template POST_TEMPLATE.md not found in workspace / 模板未找到
[PASS] Output directory posts/ exists and is writable / 输出目录存在且可写

3. Semantic Polish | 语义润色

Keyword-based sanity checks: | 基于关键词的合理性检查:

Keywords Found / 发现的关键词Warning if Missing / 缺失时警告
"upload", "post", "send"No network/API skill in dependencies / 依赖中无网络/API技能
"read", "write", "save"No file system skill declared / 未声明文件系统技能
"error", "fail", "retry"No error handling section / 无错误处理章节
"if", "check", "validate"No input validation steps / 无输入验证步骤

Usage | 使用方式

Command Line | 命令行

# Validate a draft EC / 验证EC草稿
ec_linter ExCard/temp_draft.md

# Output / 输出:
# [INFO] Scanning temp_draft.md...
# [WARN] Missing Resource Dependencies section / 缺少资源依赖章节
# [ERROR] Output path posts/ does not exist / 输出路径不存在
# [FAIL] 1 error, 1 warning found / 1个错误,1个警告

# After fixing, run again / 修复后重新运行:
ec_linter ExCard/temp_draft.md
# [PASS] All checks passed. Ready to rename to EC-XXX.md / 所有检查通过

In Agent Workflow | 在Agent工作流中

Phase 1: Observation / 阶段1:观察 Agent records successful operations in ExCard/temp_draft.md | Agent记录成功操作到 ExCard/temp_draft.md

Phase 2: Initial Structuring / 阶段2:初始结构化 Agent formats draft according to template | Agent按模板格式化草稿

Phase 3: Lint & Validate / 阶段3:检查与验证

Agent: Run ec_linter ExCard/temp_draft.md / 运行检查器
Linter: [FAIL] Missing Input conventions / 缺少输入约定
Agent: Edit file, add Input section / 编辑文件,添加输入章节
Agent: Run ec_linter again / 再次运行检查器
Linter: [PASS] / 通过

Phase 4: Activate / 阶段4:激活 Rename to EC-005-descriptive-name.md | 重命名为 EC-005-描述性名称.md


Validation Rules | 验证规则

Rule 1: Required Sections | 规则1:必需章节

Must have these Markdown H2 sections: | 必须包含以下Markdown H2章节:

  • ## Resource Dependencies / ## 资源依赖
  • ## Execution Workflow / ## 执行工作流
  • ## Execution Conventions / ## 执行约定

Rule 2: Numbered Steps | 规则2:编号步骤

Execution Workflow must use numbered list (1., 2., 3.) | 执行工作流必须使用编号列表

## Execution Workflow / ## 执行工作流
1. Read input file / 读取输入文件
2. Process data / 处理数据
3. Save output / 保存输出

Rule 3: Path Verification | 规则3:路径验证

All paths must be: | 所有路径必须:

  • Relative (not absolute) / 相对路径(非绝对路径)
  • Within workspace / 在工作空间内
  • Properly formatted / 格式正确

Rule 4: Dependency Declaration | 规则4:依赖声明

Every external tool/skill must be listed in Resource Dependencies | 每个外部工具/技能必须在资源依赖中列出

Rule 5: Error Handling | 规则5:错误处理

Must have at least one of: | 必须至少包含以下之一:

  • Error handling steps / 错误处理步骤
  • Retry logic / 重试逻辑
  • Failure recovery procedure / 故障恢复程序

Output Format | 输出格式

EC Linter Report / EC检查报告
================
File / 文件: ExCard/temp_draft.md
Status / 状态: [PASS] / [FAIL] / [WARN]

Structure Check / 结构检查:
  [✓] Resource Dependencies / 资源依赖
  [✓] Execution Workflow / 执行工作流
  [✗] Execution Conventions / 执行约定 (missing I/O paths / 缺少I/O路径)

Path Check / 路径检查:
  [✓] Input: data/input.csv
  [✗] Template: templates/missing.md (not found / 未找到)

Semantic Check / 语义检查:
  [WARN] Steps mention 'upload' but no network skill declared / 步骤提到上传但未声明网络技能
  [WARN] No error handling detected / 未检测到错误处理

Next Steps / 下一步:
  1. Add missing Execution Conventions section / 添加缺失的执行约定章节
  2. Create templates/missing.md or fix path / 创建模板或修复路径
  3. Add error handling steps or retry logic / 添加错误处理或重试逻辑

Integration with OpenExCard | 与OpenExCard集成

┌─────────────────────────────────────────┐
│     Agent observes workflow / Agent观察工作流      │
│     Records in temp_draft.md / 记录到temp_draft.md  │
└─────────────────┬───────────────────────┘
                  │
                  ▼
┌─────────────────────────────────────────┐
│   Agent formats using template / Agent使用模板格式化  │
└─────────────────┬───────────────────────┘
                  │
                  ▼
┌─────────────────────────────────────────┐
│   EC Creator Skill (ec_linter) / EC创建技能        │
│  ┌──────────────┬──────────────┐       │
│  │ Structure    │ Path         │       │
│  │ Scan / 结构  │ Vitality /   │       │
│  │    扫描      │   路径活力    │       │
│  └──────────────┴──────────────┘       │
│              │                          │
│              ▼                          │
│  ┌──────────────────────┐              │
│  │   Semantic Polish /  │              │
│  │   语义润色           │              │
│  └──────────────────────┘              │
└─────────────────┬───────────────────────┘
                  │
          [FAIL]  │  [PASS]
                  ▼
┌─────────────────┴───────────────────────┐
│  Report errors / 报告错误  │  Rename to EC-XXX.md  │
│  Agent fixes / Agent修复   │  Activate / 激活      │
│  Re-run linter / 重新运行  │                      │
└─────────────────────────────────────────┘

Installation | 安装

clawhub install ec_creator

Or clone to / 或克隆到 ~/.openclaw/skills/ec_creator/


Files | 文件

ec_creator/
├── SKILL.md              # This file / 本文档
├── ec_linter.sh          # Main validation script / 主验证脚本
├── ec_linter.py          # Python validation script / Python验证脚本
├── rules/
│   ├── structure.json    # Section requirements / 章节要求
│   ├── paths.json        # Path validation rules / 路径验证规则
│   └── semantic.json     # Keyword patterns / 关键词模式
└── templates/
    └── ec_template.md    # Starter template / 起始模板

Changelog | 更新日志

  • v1.1.0 (2026-03-14):
    • Added bilingual support / 添加中英文对照
    • Structure integrity scan / 结构完整性扫描
    • Path vitality check / 路径活力检查
    • Semantic polish / 语义润色
    • Iterative validation workflow / 迭代验证工作流
  • v1.0.0 (2026-03-14): Initial release / 初始版本

Part of OpenExCard Framework | OpenExCard框架的一部分

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.