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. | 创建标准化执行卡片的验证和修正工具
In this repository20 other files it gives its agents.
- baidu-hot-cnSkill
- coze_workflowSkill
- douyin-hot-trendSkill
- geopulseSkill
- glm-asrSkill
- glm-visionSkill
- image_gen_cozeSkill
- longtask_systemSkill
- minimax-avSkill
- rss_fetcherSkill
- scribeSkill
- skills-hubSkill
- style-fingerprintSkill
- toutiao-news-trendsSkill
- web-region-captureSkill
- weibo-hot-searchSkill
- weibo-publisherSkill
- weixin-connectorSkill
- xhs-dlSkill
- zhihu-fetcherSkill
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
- Distinctive: line 123
Must have these Markdown H2 sections: | 必须包含以下Markdown H2章节:
- Distinctive: line 141
All paths must be: | 所有路径必须:
- Distinctive: line 148
Every external tool/skill must be listed in Resource Dependencies | 每个外部工具/技能必须在资源依赖中列出
- Distinctive: line 152
Must have at least one of: | 必须至少包含以下之一:
≈ “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.
Files
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_creatorOr 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框架的一部分
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
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.

