project-layout

Enforce Sun Lab directory structure conventions across five project archetypes.

3|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/Sun-Lab-NBB/ataraxis --skill project-layout-sun-lab-nbb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-layout
Source: https://github.com/Sun-Lab-NBB/ataraxis/tree/main/plugins/automation/skills/project-layout
Command: npx skills add https://github.com/Sun-Lab-NBB/ataraxis --skill project-layout-sun-lab-nbb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures all Sun Lab projects adhere to a consistent, well-defined directory structure, making them easier to navigate, understand, and maintain across the team.

Core Features & Use Cases

  • Archetype-Specific Trees: Provides canonical directory layouts for five project types (Python-only, Python+C++ extension, C++ PlatformIO library, C++ PlatformIO firmware, C# Unity).
  • Convention Enforcement: Details common root files, environment directories, test structures, and documentation placement.
  • Use Case: When starting a new Python+C++ extension project, use this Skill to generate the correct src/, tests/, docs/, and root file structure according to Sun Lab standards.

Quick Start

Use the project-layout skill to apply the correct directory structure for a new Python-only project.

Frequently Asked Questions about project-layout

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the standard directory layout for a Python and C++ extension project?

A standard Python and C++ extension project layout uses canonical src/, tests/, docs/, and environment directories alongside specific root files. This structure separates compiled extension source code from Python modules and test suites for maintainable hybrid development.

How do I structure a PlatformIO firmware project directory?

Structure a PlatformIO firmware project by applying the C++ PlatformIO firmware archetype, which defines canonical root files, environment directories, test structures, and source code organization specifically tailored for embedded firmware development and deployment.

Does this project structure convention support C# Unity game development?

Yes, the project structure convention supports C# Unity projects as one of five archetypes. It provides a canonical directory layout detailing root files, documentation placement, and source code organization specific to Unity development workflows.

What's the best way to organize tests and documentation in a Python-only project?

The best way to organize tests and documentation in a Python-only project is following the Python-only archetype convention, which enforces specific test directory structures and documentation placement patterns to ensure project navigability and team-wide consistency.

When do I need to use the C++ PlatformIO library directory layout?

You need the C++ PlatformIO library directory layout when developing reusable embedded libraries rather than firmware, applying its specific root files, environment directories, and source code organization to ensure library portability and convention adherence.