opengis-skills
Skill83 starsChanged 6 days agoMITView on GitHub
Use when AI coding assistant needs GIS/CAD/C#/AI/IoT/3D domain expertise. Index of 120 skills across 8 categories: gis (45), cad (21), csharp (12), ai (17), iot (4), 3d (6), demos (4), others (11). Tag-based search and on-demand loading for GDAL, GeoServer, MapServer, Leaflet, PROJ, PostGIS, DuckDB Spatial, GeoLibre, JTS, CesiumJS, FreeCAD, Blender, OpenSCAD, OCCT, NPOI, SqlSugar, Furion, Serilog, Dify, Ollama, LangChain, vLLM, MinerU, SuperSplat, Home Assistant, CHAGS, MathMindForge and more.
The file
Files
SKILL.md
仓库地址： https://github.com/znlgis/opengis-skills
上游博客（对应分类）： https://znlgis.github.io/
许可证： MIT
概述
本仓库是一个面向 AI 编程助手 / Agent 的技能（Skill）集合，与任何特定 Agent 产品解耦：Claude Code / Claude、Cursor、Cline / Roo Code、GitHub Copilot、Codex、Gemini CLI、OpenCode、DeepSeek Harness 等凡是能按需读取 Markdown 的工具都可直接使用。内容涵盖开源 GIS、CAD、C#、AI、IoT、3D 六大领域，以及通用工具（others）与项目演示（demos），共 8 个分类、120 个技能文件。
每个技能以独立的 SKILL.md 文件组织，AI 工具可按需加载，作为「领域知识」注入到对话上下文，从而获得更准确的 API 调用、代码生成、错误排查和最佳实践建议。
你需要什么？
- 需要 GIS 空间数据处理？ → 加载
gis/gdal/SKILL.md - 需要用 QGIS 做批处理？ → 加载
gis/qgis-process/SKILL.md - 需要用 Java 做几何运算？ → 加载
gis/jts/SKILL.md - 需要发布地图服务？ → 加载
gis/geoserver-rest-api/SKILL.md - 需要一站式 GIS 全流程？ → 加载
gis/opengis-all/SKILL.md - 需要 CAD 参数化建模？ → 加载
cad/freecad/SKILL.md - 需要用 .NET 操作 Excel？ → 加载
csharp/npoi/SKILL.md - 需要搭建 LLM 应用？ → 加载
ai/dify/SKILL.md - 需要用纯 C# 生成建筑模型？ → 加载
3d/elements/SKILL.md - 需要 CSG 布尔运算建模？ → 加载
3d/opencsg-net/SKILL.md - 需要 .NET 错误追踪？ → 加载
csharp/sentry/SKILL.md - 需要 DeepSeek 智能体框架？ → 加载
ai/deepseek-harness/SKILL.md - 需要方案驱动的 GIS 分析/质检流水线？ → 加载
gis/opengis-daf/SKILL.md - 需要 OpenCode × DeepSeek 最优配置？ → 加载
ai/my-opencode-deepseek-config/SKILL.md - 需要 Vue3 地图/全景演示工程参考？ → 加载
demos/map-360-demo/SKILL.md或demos/vue3-map-dashboard/SKILL.md - 需要开发儿童向 H5 小游戏（Phaser + Vue3）？ → 加载
others/chags/SKILL.md或others/mathmindforge/SKILL.md - 需要轻量 Web 2D 地图？ → 加载
gis/leaflet/SKILL.md - 需要本地运行大模型？ → 加载
ai/ollama/SKILL.md - 需要发布 OGC 地图服务？ → 加载
gis/mapserver/SKILL.md
AI 使用提示： 优先使用下方标签系统精准定位所需技能，按需加载 1-3 个 SKILL.md，避免全量加载导致上下文膨胀。
技能索引
🌍 GIS — 地理信息系统（45 个）
| 技能 | 简介 | 关键标签 |
| opengis-all | 一站式 GIS 索引：GDAL + QGIS + GeoServer 全流程 | entrypoint workflow fullstack |
| gdal | GDAL 命令行：栅格/矢量处理事实标准 | cli raster vector conversion |
| gdal-api | GDAL/OGR 编程 API（C/C++/Python/.NET） | api python cpp dotnet |
| geotools | Java GIS 工具集 | java geotools feature |
| geoserver | 开源地图服务器（WMS/WFS/WMTS/WCS） | server wms wfs ogc |
| geoserver-rest-api | GeoServer REST API 自动化管理 | rest automation publish |
| geoserver-cloud | GeoServer 云原生微服务架构 | cloud kubernetes docker |
| pyqgis | QGIS Python 二次开发 | python qgis plugin |
| qgis-process | QGIS 命令行批处理 | cli processing headless |
| postgis | PostgreSQL 空间数据库扩展 | database sql spatial |
| cesiumjs | 高性能 3D 地球可视化 | javascript 3d webgl |
| openlayers | 高性能 Web 2D 地图库 | javascript webmapping 2d |
| geopandas | Python 矢量空间数据处理 | python pandas vector |
| shapely | Python 几何对象与运算 | python geometry analysis |
| jts | Java Topology Suite 几何引擎 | java geometry spatial |
| nettopologysuite | JTS 的 .NET 移植 | dotnet geometry nuget |
| geometry-api-java | Esri Geometry API for Java | java esri geometry |
| geometry-api-net | Esri Geometry API for .NET | dotnet esri geometry |
| sharpmap | .NET WinForms/Web 地图渲染库 | dotnet legacy winforms |
| mapsui | .NET 跨平台地图控件 | dotnet crossplatform maui |
| opengis-utils-for-java | OpenGIS Java 实用工具集 | java utils toolkit |
| opengis-utils-for-net | OpenGIS .NET 实用工具集 | dotnet utils toolkit |
| geopipe-agent | GIS 数据流水线 Agent（YAML 驱动） | agent pipeline yaml qc |
| opengis-daf | 方案驱动 GIS 分析与质检框架（.NET） | dotnet spatial-analysis qc pipeline |
| mapserver | MapServer：C 语言 OGC 地图服务引擎 | server wms wfs ogc |
| qgis-server | QGIS Server：发布 QGIS 工程为 OGC 服务 | qgis server wms ogc |
| leaflet | Leaflet：轻量级 Web 2D 地图库 | javascript 2d map geojson |
| proj | PROJ：坐标转换与投影引擎 | crs reprojection epsg cli |
| grass-gis | GRASS GIS：模块化地理处理套件 | gis raster vector headless |
| pdal | PDAL：点云与 LiDAR 处理流水线 | point-cloud lidar las pipeline |
| mapbox-gl-js | Mapbox GL JS：矢量瓦片 WebGL 地图 | javascript vector-tiles webgl map |
| deck-gl | deck.gl：GPU 大规模数据可视化 | javascript webgl visualization geospatial |
| geolibre | 云原生 GIS 应用：浏览器/桌面/Notebook/MCP | webgis duckdb mcp desktop |
| geonode | 地理空间 CMS：Django + GeoServer + PostGIS 数据门户 | cms django portal metadata |
| duckdb-spatial | DuckDB 空间扩展：空间 SQL 与 GeoParquet | duckdb sql geoparquet analytics |
| spatialite | SQLite 空间扩展：单文件空间数据库 | sqlite database spatial sql |
| whitebox-tools | Rust 地形/水文/LiDAR 分析引擎（CLI + Python） | cli hydrology terrain-analysis python |
| kepler-gl | React/Redux 地理数据可视化应用与组件库 | react redux visualization jupyter |
| projnet4geoapi | .NET 坐标参考系与投影引擎（NuGet ProjNet 2.x） | dotnet projection coordinate-systems wkt |
| brutile | .NET 瓦片访问库（HTTP 瓦片源 + MBTiles 离线） | dotnet tiles mbtiles tms |
| maplibre-gl-js | MapLibre GL JS：开源矢量瓦片 WebGL 地图（Mapbox GL 分支） | javascript vector-tiles webgl style-spec |
| maplibre-native | MapLibre Native：C++ 跨平台原生矢量渲染引擎 | cpp android ios offline |
| stac-cog-titiler | 影像云原生全链路：STAC + COG + TiTiler | raster cloud-native cog stac |
| geos | GEOS：C/C++ 几何引擎（PostGIS/QGIS/Shapely 内核） | geometry cpp overlay topology |
| opendronemap | OpenDroneMap/WebODM：无人机影像摄影测量全流程 | photogrammetry drone orthophoto 3d-tiles |
📐 CAD — 计算机辅助设计（21 个）
| 技能 | 简介 | 关键标签 |
| ifoxcad | AutoCAD .NET 二次开发框架 | autocad dotnet plugin |
| fy-layout | 施工场地布置插件（LightCAD 二次开发示例） | lightcad construction dotnet |
| clipper2 | 高性能 2D 多边形布尔运算与偏移 | geometry polygon clipping |
| clipper1 | Clipper 1.x（旧版本，仍广泛使用） | geometry legacy polygon |
| chili3d | 纯 Web 3D CAD（基于 OCCT.js） | web typescript wasm 3d |
| libredwg | 自由 DWG 读写库 | dwg converter library |
| qcad | 开源 2D CAD（DXF 编辑器） | dxf 2d editor |
| astral3d | 工业 3D 可视化与编辑框架 | visualization 3d rendering |
| kicad | 开源 EDA/PCB 设计套件 | eda pcb electronics |
| solvespace | 轻量参数化 2D/3D CAD | parametric constraint lightweight |
| cadquery | Python 脚本化参数化 3D CAD | python scripting occt |
| librecad | 开源 2D CAD（C++/Qt） | dxf 2d qt |
| freecad | 开源参数化 3D CAD/BIM | parametric bim python |
| occt | Open CASCADE Technology 几何内核 | kernel geometry cpp |
| openscad | 脚本式 3D CAD（CSG） | scripting csg programmatic |
| xbim | .NET BIM/IFC 工具集 | dotnet bim ifc |
| lightcad | 飞扬集成设计平台：C#/.NET 开源 CAD/BIM | dotnet cad bim plugin |
| lightningcad | 建筑围护深化设计插件（AutoCAD/ZWCAD） | autocad zwcad panel-layout |
| tongwen | CAD/BIM 工程图纸无损翻译套件（AutoCAD 2019-2026） | autocad translation i18n bim |
| design-drawing-svg-md | 设计图 SVG+MD 双载体记录（钢结构施工图→可复现图纸描述） | svg markdown pdf steel-structure llm |
| blender | Blender：Python 脚本化 3D 建模与导出 | 3d python bpy gltf |
🛠️ C# — .NET 生态（12 个）
| 技能 | 简介 | 关键标签 |
| admin-net-backend | Admin.NET 后端（基于 Furion） | dotnet backend admin |
| admin-net-frontend | Admin.NET 前端（Vue 3） | vue frontend admin |
| furion | .NET 极简企业级 Web 框架 | dotnet webapi framework |
| sod | PDF.NET SOD：ORM + SQL-MAP + OQL | orm dotnet database |
| npoi | .NET Excel/Word 读写 | excel office dotnet |
| reogrid | .NET 电子表格控件 | dotnet spreadsheet ui |
| sqlsugar | 国产高性能多数据库 ORM | orm dotnet database |
| dotnet-reactor | .NET 商业级混淆/加壳/授权 | dotnet obfuscation security |
| sentry | Sentry .NET SDK：错误追踪与性能监控 | dotnet error-tracking monitoring |
| serilog | Serilog：结构化日志（sink / enricher / JSON） | dotnet logging structured-logging |
| polly | Polly：v8 ResiliencePipeline 重试/超时/断路器 | dotnet resilience retry |
| hangfire | Hangfire：持久化后台任务与 Cron 调度 | dotnet background-jobs cron |
🤖 AI — LLM/Agent（17 个）
| 技能 | 简介 | 关键标签 |
| dify | 开源 LLM 应用开发平台 | llm rag workflow agent |
| oh-my-openagent | OmO 5.x 独立 CLI（senpi 引擎，多模型并行与 AST/LSP 工具） | agent omo orchestration cli |
| superpowers-zh | 中文 AI 编程方法论 Skills 集合 | methodology chinese skill |
| hermes-agent | 自学习通用型 AI 智能体（终端优先） | agent self-improving terminal |
| openclaw | 多通道个人 AI 助手 Gateway | agent gateway assistant |
| pi | 极简可扩展终端 AI 编码代理（Agent Harness） | agent coding-agent terminal typescript |
| opencode | 模型无关的终端 AI 编码代理（配置即代码） | agent coding-agent terminal mcp |
| docutranslate | 基于 LLM 的本地多格式文件翻译工具 | llm translation pdf mcp |
| deepseek-harness | DeepSeek Harness（dsh）：插件化智能体框架 | agent deepseek plugin cordis |
| my-opencode-deepseek-config | OpenCode × DeepSeek V4 最优配置 | opencode deepseek agent-config |
| langchain | LangChain：LLM 应用与 Agent 框架 | llm agent rag python |
| ollama | Ollama：本地大模型推理运行时 | llm local-inference rest-api |
| llamaindex | LlamaIndex：RAG 索引与查询框架 | llm rag indexing python |
| huggingface-transformers | Transformers：模型推理与微调框架 | transformers llm pytorch nlp |
| vllm | vLLM：高吞吐 LLM 推理服务（OpenAI 兼容） | llm inference serving python |
| crewai | CrewAI：角色化多 Agent 协作框架 | agent multi-agent orchestration python |
| mineru | MinerU：PDF/Office → Markdown/JSON 文档解析 | pdf parsing markdown rag |
📡 IoT — 物联网（4 个）
| 技能 | 简介 | 关键标签 |
| ke3036-keyes-pico | Keyes Raspberry Pi Pico 学习套件 | micropython rp2040 sensor |
| node-red | Node-RED：低代码 IoT 数据流编排 | iot mqtt low-code javascript |
| home-assistant | Home Assistant：本地优先家居自动化平台 | automation rest-api mqtt yaml |
| esphome | ESPHome：YAML 生成 ESP32/ESP8266 固件 | esp32 yaml ota firmware |
🧊 3D — 三维/高斯泼溅/全景（6 个）
| 技能 | 简介 | 关键标签 |
| supersplat | 浏览器端开源 3D 高斯泼溅编辑器（PlayCanvas） | 3dgs webgl typescript editor |
| ara3d-sdk | 面向 AEC 的高性能 .NET 三维/BIM 库集合（.NET 8） | bim aec dotnet geometry ifc |
| photo-sphere-viewer | JavaScript 360° 全景照片/球体查看器（Three.js 驱动） | javascript threejs panorama webgl |
| elements | Hypar Elements：纯 C# BIM 编程生成库 | dotnet bim geometry ifc gltf |
| opencsg-net | OpenCSG.NET：零依赖 .NET CSG 建模库 | dotnet csg 3d stl |
| open3d | Open3D：点云与网格处理库 | point-cloud mesh python 3d |
🎯 项目演示 — demos（4 个）
| 技能 | 简介 | 关键标签 |
| map-360-demo | 360° 全景与 Leaflet 地图双向联动演示（PSV v5） | vue panorama leaflet |
| vue3-map-dashboard | 天地图 + Element Plus 企业级可视化大屏 | vue dashboard tianditu |
| ai-water-front | OpenLayers + Dify AI 助手的智慧水务前端 | openlayers dify dashboard |
| openlayers-vue3-demo | vue3-openlayers 声明式地图 + GeoServer 图层树 | openlayers geoserver wms |
🗂️ Others — 其它（11 个）
| 技能 | 简介 | 关键标签 |
| billionmail | 自托管邮件营销与事务邮件平台 | email selfhosted marketing |
| ruoyi-cloud | 若依微服务版 Java 后台脚手架 | java springcloud scaffold |
| acme-sh | 纯 Shell 的 ACME 客户端，自动签发/续期 SSL 证书 | ssl acme lets-encrypt shell |
| go | Go 语言核心语法与工程实践 | go golang backend concurrency |
| robotgo | Go 跨平台桌面自动化（RPA）库 | go rpa automation desktop |
| robotgo-flow | 基于 robotgo 的 YAML 驱动 Windows RPA 框架 | go rpa yaml windows |
| chags | 中国历史典故儿童游戏合集（Vue3 + Phaser，17 典故） | vue phaser game |
| docker-compose | Docker Compose：多容器应用编排工具 | docker containers orchestration |
| bamboobuddy | 儿童日常养成游戏（Vue3 + Phaser，17 章教程） | vue phaser game education |
| ffmpeg | FFmpeg：音视频转码、切片与纹理帧提取 | video transcoding hls cli |
| mathmindforge | 数思工坊：数学思维闯关游戏（Vue3 + Phaser，20 关 6 模板） | vue phaser game education |
标签索引
通过标签快速定位目标技能。表中每个技能都确实带有该行的标签，可直接在 metadata.tags 中检索：
按语言/平台
| 标签 | 相关技能 |
python | open3d, crewai, deepseek-harness, docutranslate, hermes-agent, langchain, llamaindex, mineru, vllm, blender, cadquery, clipper1, freecad, kicad, libredwg, solvespace, duckdb-spatial, gdal-api, geolibre, geonode, geopandas, geopipe-agent, grass-gis, kepler-gl, pyqgis, shapely, spatialite, whitebox-tools, home-assistant |
java | gdal-api, geometry-api-java, geoserver, geoserver-cloud, geotools, jts, opengis-utils-for-java, ruoyi-cloud |
dotnet / csharp | ara3d-sdk, elements, opencsg-net, clipper1, clipper2, fy-layout, ifoxcad, lightcad, lightningcad, tongwen, xbim, admin-net-backend, dotnet-reactor, furion, hangfire, npoi, polly, reogrid, sentry, serilog, sod, sqlsugar, brutile, gdal-api, geometry-api-net, mapsui, nettopologysuite, opengis-daf, opengis-utils-for-net, projnet4geoapi, sharpmap |
javascript / typescript | photo-sphere-viewer, supersplat, deepseek-harness, openclaw, pi, astral3d, chili3d, qcad, admin-net-frontend, ai-water-front, map-360-demo, openlayers-vue3-demo, vue3-map-dashboard, cesiumjs, deck-gl, kepler-gl, leaflet, mapbox-gl-js, openlayers, node-red, bamboobuddy, chags, mathmindforge, maplibre-gl-js |
cpp / c | open3d, clipper1, clipper2, librecad, libredwg, occt, gdal-api, mapserver, geos, maplibre-native |
go / golang | go, robotgo, robotgo-flow |
shell | qgis-process, acme-sh |
vue | astral3d, admin-net-frontend, ai-water-front, map-360-demo, openlayers-vue3-demo, vue3-map-dashboard, leaflet, bamboobuddy, chags, mathmindforge, ruoyi-cloud |
micropython | ke3036-keyes-pico |
crs / reprojection / coordinate-transformation / projection | gdal, geotools, opengis-utils-for-java, opengis-utils-for-net, proj, projnet4geoapi |
按功能领域
| 标签 | 相关技能 |
geometry | ara3d-sdk, elements, opencsg-net, clipper1, clipper2, occt, xbim, geometry-api-java, geometry-api-net, geopandas, jts, nettopologysuite, opengis-utils-for-java, opengis-utils-for-net, postgis, shapely, geos |
raster | gdal, gdal-api, geopipe-agent, geotools, grass-gis, postgis, pyqgis, qgis-process, whitebox-tools, stac-cog-titiler |
vector | duckdb-spatial, gdal, gdal-api, geopandas, geopipe-agent, geotools, grass-gis, opengis-daf, opengis-utils-for-java, opengis-utils-for-net, postgis, pyqgis, spatialite |
server / wms / wfs | openlayers-vue3-demo, geoserver, geoserver-cloud, geoserver-rest-api, geotools, mapserver, mapsui, openlayers, qgis-server, sharpmap, go |
3d | ara3d-sdk, elements, open3d, opencsg-net, photo-sphere-viewer, supersplat, astral3d, blender, cadquery, chili3d, freecad, fy-layout, lightcad, occt, openscad, solvespace, cesiumjs |
2d | clipper1, clipper2, fy-layout, librecad, lightcad, qcad, solvespace, leaflet, openlayers, sharpmap |
orm / database / sql | sod, sqlsugar, duckdb-spatial, postgis, spatialite |
agent / llm | crewai, deepseek-harness, dify, docutranslate, hermes-agent, huggingface-transformers, langchain, llamaindex, my-opencode-deepseek-config, oh-my-openagent, ollama, openclaw, opencode, pi, vllm, design-drawing-svg-md, geopipe-agent |
pipeline / workflow | crewai, dify, design-drawing-svg-md, geopipe-agent, opengis-all, opengis-daf, pdal, qgis-process, robotgo-flow |
automation / rpa | geoserver-rest-api, grass-gis, qgis-process, home-assistant, node-red, acme-sh, robotgo, robotgo-flow |
lidar / point-cloud | open3d, pdal, whitebox-tools, opendronemap |
vector-tiles / webgl / webgpu | photo-sphere-viewer, supersplat, cesiumjs, deck-gl, kepler-gl, mapbox-gl-js, openlayers, maplibre-gl-js, maplibre-native |
docker / containers | dify, geolibre, geonode, geoserver-cloud, home-assistant, billionmail, docker-compose, opendronemap |
iot / mqtt | esphome, home-assistant, ke3036-keyes-pico, node-red |
autocad | ifoxcad, lightningcad, tongwen |
svg / markdown / pdf | docutranslate, mineru, design-drawing-svg-md |
panorama / 360-photo | photo-sphere-viewer, map-360-demo |
dashboard / demo | hangfire, ai-water-front, map-360-demo, openlayers-vue3-demo, vue3-map-dashboard, node-red |
video / media / transcode | ffmpeg |
game / education | bamboobuddy, chags, mathmindforge |
bim / ifc | ara3d-sdk, elements, astral3d, freecad, fy-layout, lightcad, lightningcad, tongwen, xbim |
parametric | elements, cadquery, chili3d, freecad, openscad, solvespace |
AI 工具使用指南
按需加载（推荐）
根据用户问题，只加载 1-3 个最相关的 SKILL.md：
场景示例：
| 用户需求 | 加载技能 |
| "帮我把 Shapefile 转成 GeoJSON" | gis/gdal/SKILL.md |
| "用 Python 计算两个面的交集" | gis/shapely/SKILL.md |
| "用 QGIS 批处理做缓冲区分析" | gis/qgis-process/SKILL.md |
| "如何发布矢量数据到 GeoServer？" | gis/geoserver-rest-api/SKILL.md |
| "PostGIS 怎么建空间索引？" | gis/postgis/SKILL.md |
| "用 .NET 读取 Shapefile" | gis/nettopologysuite/SKILL.md |
| "Java 几何运算怎么做？" | gis/jts/SKILL.md |
| "前端展示 WMS 地图图层" | gis/openlayers/SKILL.md 或 gis/cesiumjs/SKILL.md |
| "用 CAD 画个简单的 3D 零件" | cad/openscad/SKILL.md 或 cad/cadquery/SKILL.md |
| "用 .NET 写一个 Web API 接口" | csharp/furion/SKILL.md |
| "全景图与地图双向联动怎么做？" | demos/map-360-demo/SKILL.md |
| "用 Phaser + Vue3 做儿童小游戏" | others/chags/SKILL.md |
| "做数学思维闯关 / 自动判题关卡" | others/mathmindforge/SKILL.md |
| "本地部署并调用大模型" | ai/ollama/SKILL.md |
| "用 LangChain 搭 RAG/Agent 应用" | ai/langchain/SKILL.md |
全量加载
当用户需求横跨多个领域或不确定具体工具时，先加载本文件（根 SKILL.md）获取全局索引，再按需加载子技能。
Skill 加载方式
本仓库是纯 Markdown，不依赖任何特定 Agent 产品。各工具的通用做法：
# Claude Code / Claude
@SKILL.md # 加载根入口（推荐）
@gis/gdal/SKILL.md # 加载 GDAL 技能
# Cursor / Cline / Roo Code
把 SKILL.md 路径写进 .cursorrules / .clinerules，或在对话里 @file 引用
# GitHub Copilot Chat
通过 .github/copilot-instructions.md 指向根 SKILL.md，或对话中 #file 引用
# Codex / Gemini CLI / Aider / OpenCode 等 CLI Agent
直接把 `SKILL.md`（或分类级 / 项目级 SKILL.md）作为上下文文件提供给 Agent，
或让 Agent 按路径自行 read；支持技能目录的宿主可把本仓 `<category>/<skill>/`
整个目录注册为技能兼容性原则： 技能正文只写工具无关的知识（版本、API、命令、工作流、排障），不假设 Agent 具备特定工具名或私有 API；「AI 使用建议」一节描述的是通用协作方式（如何加载、用什么命令、怎么验证产物），任何 Agent 都能照做。
Skill 编写规范
完整规范见 AUTHORING.md（唯一权威，含示例与检查清单），摘要如下：
- 目录与命名 —
<category>/<project>/SKILL.md；目录名 kebab-case（^[a-z0-9]+(-[a-z0-9]+)*$）且与 frontmattername完全一致；详细资料放reference/*.md（一层深、从 SKILL.md 链接） - YAML frontmatter — 只用 Agent Skills 规范允许的六个字段：
name、description、license（本仓统一MIT）、compatibility、metadata、allowed-tools；标签放metadata.tags（逗号分隔字符串，5–10 个） - description — 英文、
Use when开头、第三人称、≤500 字符、不含尖括号；写「何时使用」并嵌入 API/命令/报错原文等触发词 - 头部引用块 — 项目地址、官方文档、最新版本（含「截至 YYYY-MM」与来源链接）、许可证
- 正文章节 — 概述 → 环境准备/安装 → 核心 API/命令 → 典型工作流 → 常见问题（表格 ≥5 行）→ AI 使用建议（工具无关）→ 相关技能 → 参考资源
- 渐进披露 — 主文件 ≤500 行；
reference/文件 >100 行须有## Contents；无孤儿文件 - 质量 — 版本与 API 以官方来源实测为准，禁止编造；无 emoji、代码围栏必须带语言、文件链接用正斜杠
参考样板：gis/gdal/SKILL.md、gis/jts/SKILL.md
贡献指南
- 每个 Skill 以独立目录组织：
<category>/<project>/SKILL.md - 新增/删除技能时同步更新 4 处：根
SKILL.md、所属分类索引、README.md、标签表 - 基于上游官方文档编写，避免编造 API；版本号与「最新版本」行必须给出实测来源
- 保持中文为主，代码、命令、API 使用原文格式
- 提交 PR 前在仓库根目录运行：
python scripts/validate-skills.py . # 结构/frontmatter/索引/链接（CI 同款） python scripts/check-upstream.py . # 上游版本漂移（需联网，可选） - 提交 PR 时确保 frontmatter 符合 AUTHORING.md（
metadata.tags用逗号分隔字符串，不再使用顶层tags数组）
许可证
本仓库自身代码与文档遵循 MIT License。各 SKILL 中引用、介绍的上游开源项目，请以其各自仓库的许可证为准。
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.