semantic-contract SKILL.md skillA

semantic-contract from echoyue-lp/echo-agent is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add echoyue-lp/echo-agent/semantic-contract@git:20260908.7e2cb50

Pins git:20260908.7e2cb50 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
echoyue-lp/echo-agent
Path
.agents/skills/semantic-contract/SKILL.md
Versions recorded
1
Latest version
git:20260908.7e2cb50, committed Sep 8, 2026
Size
1,516 bytes
Repository stars
89
License
MIT

提供语义材料版本 1 的唯一对象、引用、状态、风险视角和结构校验合同;仅在其它语义 Skill 要读写语义对象, 或用户要求检查语义材料格式与合同漂移时使用,不负责普通代码审查。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 语义材料合同

本 Skill 是当前仓库语义对象格式的唯一入口。它不判断业务行为是否正确,也不创建运行时存储或调度器。
结构校验需要 `uv`,或已安装 PyYAML 的 Python 3.9 及以上版本;环境不满足时报告缺口,不跳过校验。

## 输入

- 仓库根绝对路径;
- 操作:读取合同、校验现有 `semantic/`,或运行校验器自测;
- 可选的另一个合同文件绝对路径,用于跨仓一致性检查。

## 工作流

1. 需要创建、更新或解释语义对象时,读取 `references/semantic-artifact-contract.md`。
2. 需要校验磁盘材料时,在本 Skill 根目录运行 `uv run scripts/verify_semantic.py --root <仓库根绝对路径>`。
3. 修改校验器后运行 `uv run scripts/verify_semantic.py --self-test`。
4. 同时修改两个仓库的合同后,对两个合同文件做字节一致性检查;不一致时不得继续写对象。

## 输出

返回合同版本、校验范围、错误列表、退出码和不能证明的内容。结构通过只代表材料可解析且引用完整,
不代表行为正确、审查充分或仓库没有缺陷。

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add echoyue-lp/echo-agent/semantic-contract@sha256:723a74cefe6c1cc4

The line at the top of this page pins the label git:20260908.7e2cb50, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_uq4dhw72nnxrj5hx.svg)](https://markdownregistry.com/a/art_uq4dhw72nnxrj5hx)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 8, 2026.

versioncommittedcommitsizeaudit
git:20260908.7e2cb50 latest2026-09-08 7e2cb50 1,516 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (1516 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

echoyue-lp/echo-agent · 89 stars · license MIT · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_uq4dhw72nnxrj5hx
GET https://markdownregistry.com/api/v1/resolve?ref=echoyue-lp/echo-agent/semantic-contract
GET https://markdownregistry.com/api/v1/blob/723a74cefe6c1cc456ec7c9a8f21d0c7cbf75cd957ba93e31491d3f65de16fe0

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from echoyue-lp/echo-agent

coding-preflight SKILL.md skill
echoyue-lp/echo-agent · .agents/skills/coding-preflight/SKILL.md · 在 echo-agent 开始缺陷修复、功能开发、重构、契约或样式改动前,先完成复用搜索、架构分层、状态权威、 修改边界和验证范围预检;当新需求可能导致重复代码、相近概念、公共接口漂移或风格分裂时使用,不负责首次全量语义建库。
git:20260908.7e2cb50 · audit A · 89 stars
semantic-audit SKILL.md skill
echoyue-lp/echo-agent · .agents/skills/semantic-audit/SKILL.md · 针对指定语义边界和风险视角进行有界、可反证的质量审查,记录故障假设、实现路径、证据、问题记录和残余风险; 仅在已有“边界 × 风险视角 × 源码版本”单元及进入原因时使用,不负责普通差异分析或一般代码审查。
git:20260908.7e2cb50 · audit A · 89 stars
semantic-decide SKILL.md skill
echoyue-lp/echo-agent · .agents/skills/semantic-decide/SKILL.md · 把真实产品预期、语义冲突或残余风险整理成一个需要人的明确裁决单元; 仅在已有具体行为承诺、规则或问题记录无法由证据确定时使用,不负责普通设计讨论或一般代码审查。
git:20260908.7e2cb50 · audit A · 89 stars
semantic-diff SKILL.md skill
echoyue-lp/echo-agent · .agents/skills/semantic-diff/SKILL.md · 分析代码、配置、契约或工作树差异对既有语义基线的影响,计算影响闭包并标记需要重新审查的风险视角; 仅在已有实际差异且存在语义基线时使用,不负责首次建库、编码前预检或泛化代码审查。
git:20260908.7e2cb50 · audit A · 89 stars
semantic-discover SKILL.md skill
echoyue-lp/echo-agent · .agents/skills/semantic-discover/SKILL.md · 建立或补全仓库的语义行为基线,识别能力边界、状态权威、重要入口、证据缺口和未知区; 仅在首次建立、扩大或修复 `semantic/` 基线覆盖时使用,不负责普通新需求预检、已有差异分析或代码审查。
git:20260908.7e2cb50 · audit A · 89 stars
semantic-verify SKILL.md skill
echoyue-lp/echo-agent · .agents/skills/semantic-verify/SKILL.md · 校验语义材料的结构、引用、源码快照、新鲜度和解决条件,并在静态事实不足时运行最小必要验证; 仅在已有 `semantic/` 材料或问题记录解决候选时使用,不替代普通代码完成验证或仓库合并门禁。
git:20260908.7e2cb50 · audit A · 89 stars
AGENTS.md AGENTS.md file
echoyue-lp/echo-agent · AGENTS.md
git:20261023.5172645 · audit A · 89 stars
code-review SKILL.md skill
echoyue-lp/echo-agent · echo-agent-learning/examples/demo_skills/code-review/SKILL.md · Professional code review skill: identify defects, security risks, and best practice violations. Use when asked to…
v2.0.0 · audit A · 89 stars
data-analyst SKILL.md skill
echoyue-lp/echo-agent · echo-agent-learning/examples/demo_skills/data-analyst/SKILL.md · Data analysis skill: statistical analysis, data interpretation, and visualization recommendations. Use when asked to…
v2.0.0 · audit A · 89 stars
project-stats SKILL.md skill
echoyue-lp/echo-agent · echo-agent-learning/examples/demo_skills/project-stats/SKILL.md · Analyze project structure, count lines of code by language, find TODOs/FIXMEs, and generate project health summaries…
v2.0.0 · audit A · 89 stars
python-linter SKILL.md skill
echoyue-lp/echo-agent · echo-agent-learning/examples/demo_skills/python-linter/SKILL.md · Lint and format Python files using ruff. Activates automatically when Python files are touched. Use to check code…
v1.0.0 · audit A · 89 stars
web-researcher SKILL.md skill
echoyue-lp/echo-agent · echo-agent-learning/examples/demo_skills/web-researcher/SKILL.md · Web research skill: systematically collect, verify, and synthesize information from multiple sources. Use when asked to…
v1.2.0 · audit A · 89 stars

Every file in echoyue-lp/echo-agent

Browse by kind, by grade A, or by owner.