Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add flanliulf/SpecLite --skill speclite-agent-lintgit clone --depth 1 https://github.com/flanliulf/SpecLiteWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/flanliulf/speclite/speclite-agent-lint)<a href="https://agentmods.dev/skills/flanliulf/speclite/speclite-agent-lint"><img src="https://agentmods.dev/badge/skills/flanliulf/speclite/speclite-agent-lint/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/flanliulf/speclite/speclite-agent-lint"><img src="https://agentmods.dev/badge/skills/flanliulf/speclite/speclite-agent-lint.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00109 | $0.01236 |
| Opus 5 | $0.00055 | $0.00618 |
| Sonnet 5 | $0.00022 | $0.00247 |
| Haiku 4.5 | $0.00011 | $0.00124 |
Grade A, and why
speclite-agent-lint scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
[Overview(技能说明)]
Speclite Agent Lint 是只读规范检查器,用于审查 speclite-agent-* 定义包。它在通用 Skill 规则基础上增加 Agent 专属语义检查,重点防止 [agent] 被误检为 [workflow]、菜单目标断链、persona 激活语义丢失和 BMad runtime 残留。
[Core Capabilities(核心能力)]
- 通用 Skill 合规检查:验证 YAML frontmatter、description、allowed-tools、metadata、版本一致性、正文长度、必需章节和引用路径。
- Agent 定制块检查:确认 customize.toml 存在 [agent],关键字段完整,数组与数组表结构符合合并规则。
- 激活流程检查:确认入口使用 Speclite resolver 的 --key agent,并保留 persona、persistent facts、config、greet、menu dispatch 和持续身份规则。
- 菜单完整性检查:验证 [[agent.menu]] 的 code 唯一、description 非空、每项只能包含 skill 或 prompt 之一,并检查目标 Skill 或本地 prompt 文件存在。
- Speclite 运行模型检查:扫描 _bmad、config.yaml、/bmad:*、源码仓库 runtime 依赖和 config fallback 误用。
- Deterministic 脚本检查:运行 scripts/check_agent_skill.py,用可复核 JSON 结果支撑人工报告。
- 文件归类检查:检查根目录 Markdown 白名单、prompt 文件迁移、references/ 与 assets/ 职责边界。
- 修复方案输出:按 Critical / Major / Minor / Observation 输出证据、影响、建议调整和验证方式。
[Workflow(执行流程)]
1. 确认目标 Agent Skill 目录、Skill 名称或 --all 扫描根;若未提供路径或名称,先询问,不猜测。
2. 完整阅读 references/lint-rules.md,按规则读取目录、SKILL.md、CHANGELOG.md、customize.toml、引用的 references/assets 和本地 prompt。
3. 对目标目录运行只读脚本:python3 scripts/check_agent_skill.py <agent-dir>;批量扫描时运行 python3 scripts/check_agent_skill.py --all assets/source/speclite/sdlc-skills。
4. 执行通用规则:frontmatter、description、版本、正文章节、根目录文件、引用路径和命名。
5. 执行 Agent 专属规则:[agent] 字段、激活流程、--key agent、persona 语义、菜单项、prompt 文件、持续身份。
6. 执行 Speclite 专属规则:runtime 路径、_speclite/config.toml、custom fallback、BMad 残留、公共源码目录混用。
7. 输出报告:使用 assets/report-template.md 格式,列出结论、Findings、调整方案和验证建议。
8. 如果用户要求重新检查,重新执行完整扫描并标注已修复、新增和仍存在问题。
[Notes(注意事项)]
- 本 Skill 属于 support-skills/,只服务 SpecLite canonical skill 源定义检查,不属于目标项目默认 SDLC runtime 安装集合。
- 默认只读,绝不修改目标 Agent Skill 文件。
- scripts/check_agent_skill.py 是确定性证据来源;人工报告不得与脚本中的 Critical/Major 结论矛盾。
- customize.toml 对 Agent 必须承载 [agent],不能套用 workflow-only lint 规则。
- Agent 包的 SKILL.en.md 不是硬性必需项;如存在,必须与中文 canonical 入口保持版本和运行模型一致。
- CHANGELOG.md 可以保留 BMAD 来源说明;SKILL.md 和当前 references 不得把 BMAD 路径写成运行依赖。
- 菜单目标不存在时通常是 Major;如果入口会直接分发到不存在的必需目标,可升级为 Critical。
- prompt 引用的文件是执行指令,缺失或路径未迁移会导致 Agent 菜单项不可用。
- 报告必须用中文,路径使用工作区相对路径。
[Generation Metadata(生成信息)]
本 Skill 由 speclite-agent-creator 维护并纳入 SpecLite support-skills 体系。如需修改,必须同步更新 SKILL.md、SKILL.en.md、CHANGELOG.md、references/、assets/ 和 scripts/。
What ships with it
5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 8d ago First seen · 47 lines · 109 tokens per session scan A e59c186580b2
speclite-agent-lint is a skill published in the GitHub repository flanliulf/SpecLite (4 stars, last pushed 2mo ago), licensed MIT. It adds 109 tokens to every session and 1,236 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
lain
Structural code intelligence for AI coding agents. Use this skill when the user wants to understand how a codebase is organized (modules, call graphs, file dependencies), find where to start reading, trace the impact of a change, find code by meaning, or understand what a symbol does in its full context. Do NOT use…
botpipe-workflow-authoring
Author, review, and improve Botpipe workflows. Use when Codex is asked to create packaged or workspace-local Botpipe workflows, convert codebases into workflows, design provider-heavy producer/verifier steps, write Botpipe prompts/contracts, inspect Botpipe traces, or apply Codex CLI/gpt-5.5 workflow patterns.
intake
The planning front-door. Captures feature ideas and bugs as graded rows in the root INTAKE.md ledger. Use it when the user says "log an idea", "capture a bug", "add to the backlog", "note this down", "track this feature", or invokes /intake. Owns the requirements interview — fleshes out thin ideas, proactively…
pre-merge
The CI gate. Takes a feature branch from "eng says done" to "PR open against staging with green checks". Runs the project's preflight-resolved pipeline from devkit/policy.json components[]: sync → parallel correctness + security waves → coverage → regression tail → security/migration → PRD-consistency → open PR. Emits…
merge
The ship gate — the only skill that merges. --staging merges the feature→staging PR on green CI, deploys, verifies, emits a human test script and stamps the staging sign-off on approval. --production ships the double-confirmed release to main and deploys production. Never self-certifies staging; nothing reaches main…
msg
Root menu for msg skills, plus harness modes. --init is the one-time project bootstrap — use it when the user says "initialise project", "bootstrap repo", "set up the framework", "start a new project", or asks to set up project structure in an empty repo. Other modes: --init-staging (add a staging branch), --update…