Skill: Project Metadata & Inventory
This skill provides a standardized set of queries for auditing top-level project information and model structure. It acts as the "Project Passport," giving agents immediate context about the model's identity and discipline.
1. Core Logic & Assumptions
Categorical Filtering
- •Metadata: Extracted from the
elementstable wherecategory_name = 'Project Information'. - •Inventory: Levels, Sheets, and Links are identified by their specific
category_name(e.g.,Levels,Sheets).
Scoping
This skill distinguishes between the active document (scope: 'active') and the entire loaded ecosystem (scope: 'global').
2. Capability Manifest (Query Map)
The skill is modularized into dedicated SQL files:
| Query File | Description | Output |
|---|---|---|
extract-project-info.sql | Project Passport | Name, Number, Client, Discipline, Address. |
list-levels.sql | Spatial Context | Elevation-sorted list of project levels. |
list-sheets.sql | Drawing List | Comprehensive sheet index. |
list-linked-models.sql | Link Registry | Inventory of all attached Revit models. |
3. Best Practices for Developers
- •Verification First: Always run
extract-project-info.sqlduring the planning phase to confirm you are in the correct model. - •Elevation Logic: When listing levels, always sort by
elevationto maintain spatial hierarchy. - •Global Awareness: Use the
global/variant of these queries if the task requires cross-model coordination (e.g., "Find all architectural sheets across all links").
4. When to use this skill
- •At the start of a task to gather project-wide context.
- •When the user asks for high-level statistics (e.g., "How many levels are in this building?").
- •When auditing sheet numbers or project addresses for documentation.
5. When NOT to use this skill
- •For quantitative element takeoffs (Pipes, Walls). Use category-specific analytical skills instead.
- •For detailed parameter inspection of individual instances.