skills README

The project's README from github.com/almendili/skills. As one markdown file: README.md.

skills

Agent skills — portable instruction packs in the SKILL.md format, usable by any harness that reads it (Claude Code, Codex, Cursor, Gemini CLI, and others).

Skill What it does
architecture-map Builds an interactive isometric map of a repository — buildings sized by real measurements, flows tracing real call paths, and a drift counter that fails CI when the map falls behind the code.

Installing

Skills are discovered from a directory your tool scans. Symlink rather than copy, so git pull here updates every install at once:

# Claude Code (global, all projects)
ln -s "$PWD/architecture-map" ~/.claude/skills/architecture-map

# Codex
ln -s "$PWD/architecture-map" ~/.codex/skills/architecture-map

# Tools using the shared convention
ln -s "$PWD/architecture-map" ~/.agents/skills/architecture-map

# Scoped to one project, whatever the tool
ln -s "$PWD/architecture-map" /path/to/repo/.claude/skills/architecture-map

Create the target directory first if it does not exist. Skills load when a session starts, so open a new one afterwards.

What is in a skill

Portability

Nothing here depends on a specific harness. Where a skill wants a structured question it names one tool's mechanism as an example and gives a plain-text fallback; where it needs its own directory it resolves the path rather than reading a tool-specific environment variable.

skills (almendili/skills)

Searching Database…

382 ·GitHub
这是什么?一组智能体技能——以 SKILL.md 格式编写的可移植指令包,任何 AI 编程智能体框架都能加载使用,包括 Claude Code、Codex、Cursor 和 Gemini CLI。
这是代码库,还是别的东西?它不是导入代码的库——每个技能是一个文件夹,包含 markdown 指令、可选的参考文档、脚本和资源,由 AI 智能体在运行时读取和执行。
怎么安装这些技能?把这个仓库(或单个技能文件夹)用符号链接放进你的智能体框架扫描技能的任意目录,如果目标目录不存在就先创建它。
哪些编程智能体真正能用这些技能?任何读取 SKILL.md 格式的框架都可以,其中 Claude Code、Codex、Cursor 和 Gemini CLI 被明确列为受支持。
安装技能后需要重启什么吗?需要——技能只在会话启动时加载,所以用符号链接装好技能后,你需要在智能体工具里开一个新会话。
自带的 “architecture-map” 技能是做什么的?它为仓库构建一张可交互的等距视图地图,建筑大小由真实度量决定,流向追踪真实的调用路径,还有一个偏移计数器,当地图与代码不同步时会让 CI 失败。
技能是怎么决定何时触发的?SKILL.md 的 YAML frontmatter 里的 description 字段写明技能应该适用的情形,而不只是描述它做什么,框架就是拿它来匹配的。
除 SKILL.md 外,技能还能包含哪些文件?技能可以有 references/ 文件夹存放按需加载的详细资料,scripts/ 文件夹存放技能运行的可执行文件(相对技能自身目录解析,而不是目标项目),以及 assets/ 文件夹存放复制到正在处理项目中的文件。
这些技能是否绑定某一个特定 AI 工具的功能?不是——当技能需要某种结构化机制时,它会以某个工具的功能举例说明,但总是提供纯文本的替代方案,而且它解析自身目录路径,不依赖某个工具专用的环境变量。
Creator
almendili
Size
0.1 MB
Stars
382
Updated
CommitAug 18
Age
2mo
Commits · 90 Days