Project skills

Project skills travel with a drawing. They live in a folder next to the drawing file, so anyone who opens that drawing — you on another machine, or a colleague — automatically gets the same skills. This is the best place for standards that belong to a particular project or client.

Where they live

In the same folder as your drawing, create a .cizgen/skills folder and put one markdown file per skill inside it:

my-project/
├─ site-plan.dwg
└─ .cizgen/
   └─ skills/
      ├─ site-standard.md
      └─ layer-standard.md

Each .md file becomes one skill, named after the file. It shows up in the panel with a Project badge, ready to mention with /.

The skill file format

A skill file is plain markdown with a small header (front matter) and a body of guidance:

---
name: layer-standard
description: Our office layer names and colors.
---

When creating or changing layers, follow our standard:

- Walls go on `A-WALL` (color 7).
- Text and notes go on `A-ANNO-TEXT`.
- Never draw on layer `0`.

If a required layer doesn't exist, create it before drawing on it.

• name — how you'll mention it (/layer-standard). Keep it short, lowercase, with dashes.

• description — a one-line summary shown in the skill list.

• Body — write the guidance in plain language, as if briefing a colleague. Be specific.

• tags (optional) — labels used to browse the community if you ever share the skill. Write them on one line (tags: layers, standards) or as a list, both work:

  tags:
    - layers
    - standards

• autonomy: guided (optional) — turns the assistant into a coach while the skill is mentioned: instead of doing the task itself, it guides you step by step, asks short questions, and only draws in your drawing when you explicitly ask it to ("draw it for me", "show me an example"). Use it for tutoring or training skills; leave it out for normal "do the work" skills.

Let Cizgen write one for you

You don't have to hand-write skill files. Cizgen can create a project skill for you — most usefully, a reusable inspection standard that it can then check drawings against automatically. See Inspection standards.