{"id":49659454,"url":"https://github.com/adn-devtech/acad-api-skill","last_synced_at":"2026-05-06T11:05:47.144Z","repository":{"id":353493844,"uuid":"1215978264","full_name":"ADN-DevTech/acad-api-skill","owner":"ADN-DevTech","description":"AI agent skills and rules for scaffolding and building AutoCAD, Civil 3D, and Plant 3D .NET 10 plugins","archived":false,"fork":false,"pushed_at":"2026-04-24T05:11:10.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T07:16:06.169Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ADN-DevTech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-20T12:50:26.000Z","updated_at":"2026-04-24T05:11:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ADN-DevTech/acad-api-skill","commit_stats":null,"previous_names":["adn-devtech/acad-api-skill"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ADN-DevTech/acad-api-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ADN-DevTech%2Facad-api-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ADN-DevTech%2Facad-api-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ADN-DevTech%2Facad-api-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ADN-DevTech%2Facad-api-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ADN-DevTech","download_url":"https://codeload.github.com/ADN-DevTech/acad-api-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ADN-DevTech%2Facad-api-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32690566,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T08:33:17.875Z","status":"ssl_error","status_checked_at":"2026-05-06T08:33:17.221Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-06T11:05:43.677Z","updated_at":"2026-05-06T11:05:47.122Z","avatar_url":"https://github.com/ADN-DevTech.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# AutoCAD API Skills\n\nAI agent skills for building AutoCAD, Civil 3D, and Plant 3D plugins with .NET 10.\n\nThese aren't generic prompts. They're verified API patterns, assembly maps, and deployment recipes that stop your AI assistant from hallucinating outdated .NET Framework code and crashing your plugin at runtime.\n\nThe original motivation: AI assistants couldn't write even a HelloWorld plugin for Plant 3D. The API documentation is scarce — mostly offline CHM files bundled with a separately downloaded SDK, no NuGet packages, and very few public examples. This skill set captures what a senior developer knows so the AI doesn't have to guess.\n\n## Why this exists\n\nAI assistants are trained on years of StackOverflow posts and blog articles — most of which target AutoCAD 2015–2024 with .NET Framework 4.8. Ask one to scaffold a plugin today and you'll get code that compiles but fails to load because it used `\u003cRuntimeIdentifier\u003e` (creates a subfolder AutoCAD can't probe), referenced `AcMgd.dll` in a Design Automation context, or forgot that Civil 3D's `Entity` class collides with AutoCAD's.\n\nThis skill set gives your AI the same knowledge a senior AutoCAD developer carries in their head:\n\n- **Correct assembly loading** — which DLLs go where, what to exclude, what never to copy\n- **Project scaffolding** — `dotnet new` templates with the right csproj settings out of the box\n- **Deployment patterns** — `.bundle` packaging, `PackageContents.xml`, accoreconsole testing with `/al`\n- **Explicit guardrails** — \"do NOT\" rules that prevent the most common AI mistakes\n- **SDK-grounded lookup** — teaches the AI to search local SDK samples with `rg` before inventing API usage\n\n### It learns as you work\n\nInspired by [Karpathy's LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f), the AI appends new discoveries to `skills/learnings.md` during development sessions. You review, verify against the SDK, and promote the good ones into the canonical skill files. Knowledge compounds. The AI never overwrites verified facts on its own.\n\n## Quick Start\n\n\u003e 💡 Install at the **Workspace level**, not globally. You don't want AutoCAD rules polluting your web projects.\n\n```bash\nmkdir MyPlugin \u0026\u0026 cd MyPlugin\nnpx github:ADN-DevTech/acad-api-skill\n```\n\nThis copies the skill files, registers the `dotnet new acad` and `dotnet new civil` templates, and you're ready to go.\n\n### Target a specific assistant\n\n```bash\nnpx github:ADN-DevTech/acad-api-skill -a cursor\nnpx github:ADN-DevTech/acad-api-skill -a github-copilot\nnpx github:ADN-DevTech/acad-api-skill -a claude\n```\n\nBehind a VPN? Add `--registry=https://registry.npmjs.org/` before the package name.\n\n### Uninstall\n\n**1. Unregister the `dotnet new` templates**\n\nFrom any directory (while online so `npx` can resolve the package), run:\n\n```bash\nnpx github:ADN-DevTech/acad-api-skill uninstall\n```\n\nThat runs `dotnet new uninstall` for the AutoCAD and Civil 3D template folders shipped with this package. Assistant flags such as `-a cursor` are ignored for `uninstall` (templates are global to the machine). If you installed templates from a **cloned repo** instead of `npx`, use the same paths you used with `dotnet new install`:\n\n```bash\ndotnet new uninstall ./templates/acad\ndotnet new uninstall ./templates/civil\n```\n\nIf a template was registered from an **old npx cache path** (rare after cache cleanup), list everything and remove by the exact path shown:\n\n```bash\ndotnet new uninstall\n```\n\nCopy the `dotnet new uninstall \u003cpath\u003e` line next to the `acad` / `civil` entries you want to drop.\n\n**2. Remove copied skill files from your project**\n\nThe installer only **copies** files; it does not track them for automatic removal. Delete what you added, depending on how you installed:\n\n| You ran | Typical folders / files to remove from the project root |\n|---------|-----------------------------------------------------------|\n| Default (all assistants) | `skills/`, `.cursor/`, `.github/`, `CLAUDE.md` |\n| `-a cursor` | `skills/`, `.cursor/` |\n| `-a github-copilot` | `skills/`, `.github/` (or only `.github/copilot-instructions.md` if you merged other GitHub metadata) |\n| `-a claude` | `skills/`, `CLAUDE.md` |\n\nIf you merged AutoCAD rules into an existing `.cursor/rules/` tree, remove only the skill-related rule files (for example `acad-plugin.mdc`) instead of deleting the whole `.cursor/` folder.\n\n**3. Assistant-specific settings (global installs)**\n\nIf you followed **Manual Installation** and copied files into your user profile or pasted Copilot instructions into VS Code settings, undo those steps in Cursor / VS Code / Claude Code settings and delete any copied global `skills` copy you added.\n\nCanonical checklist for humans and agents also lives in **[`CLAUDE.md`](CLAUDE.md)** (section *Uninstalling the skill pack*).\n\n---\n\n## Manual Installation\n\n### Cursor\n\n- **Global:** Copy `.cursor/rules/` → `%USERPROFILE%\\.cursor\\rules\\` and `skills/` → `%USERPROFILE%\\.cursor\\skills\\`\n- **Workspace:** Copy `.cursor/rules/` and `skills/` into your project root\n\n### VS Code (GitHub Copilot)\n\n- **Global:** Add contents of `.github/copilot-instructions.md` to `github.copilot.chat.codeGeneration.instructions` in your settings\n- **Workspace:** Copy `.github/copilot-instructions.md` and `skills/` into your project\n\n### Claude Code\n\n- **Workspace:** Copy `CLAUDE.md` and `skills/` to your project root\n- **Global:** `claude config set custom_instructions \"...\"`\n\n---\n\n## What's in the box\n\n| File | What it does |\n|------|-------------|\n| `skills/scaffold.md` | End-to-end project creation: templates, csproj fixes, bundling, deployment |\n| `skills/autocad-api.md` | Assembly/DLL map, plotting API, accoreconsole flags, common gotchas |\n| `skills/civil3d-api.md` | Alignments, surfaces, corridors, pipe networks, data shortcuts |\n| `skills/plant3d-api.md` | P\u0026ID world map, data manager, pipe routing, project access |\n| `skills/code-sleuth.md` | How to find SDK samples and query the Autodesk Help MCP server |\n| `skills/learnings.md` | Append-only discovery log — human-reviewed before promotion |\n| `templates/acad/` | `dotnet new acad` template (auto-installed) |\n| `templates/civil/` | `dotnet new civil` template (auto-installed) |\n\n## Links\n\n- **Repository:** [github.com/ADN-DevTech/acad-api-skill](https://github.com/ADN-DevTech/acad-api-skill)\n- **AutoCAD .NET API Reference:** [help.autodesk.com](https://help.autodesk.com/view/OARX/2027/ENU/?guid=GUID-C3F3C736-40CF-44A0-9210-55F6A939B6F2)\n- **Autodesk Help MCP Server:** `https://developer.api.autodesk.com/knowledge/public/v1/mcp`","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadn-devtech%2Facad-api-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadn-devtech%2Facad-api-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadn-devtech%2Facad-api-skill/lists"}