donna-start

Start a Donna session and load project intro artifacts via CLI.

27|6|Updated Dec 24, 2025
One-click install
npx skills add https://github.com/Tiendil/donna --skill donna-start
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: donna-start
Source: https://github.com/Tiendil/donna/tree/main/donna/fixtures/skills/donna-start
Command: npx skills add https://github.com/Tiendil/donna --skill donna-start

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Donna-start automates the initial onboarding steps required for an agent to operate within Donna-managed workflows by ensuring a session is created and the project's introductory artifacts are loaded, preventing confusion and wasted steps at the start of work.

Core Features & Use Cases

  • Session Initialization: Ensures a fresh Donna session is started so subsequent workflow commands execute in a managed context.
  • Project Introduction Retrieval: Directs the agent to load the project's intro artifacts to gain necessary context before performing tasks.
  • Use Case: When a developer asks an agent to work on a repository using Donna, use this Skill to bootstrap the environment and then select the appropriate Donna workflow to perform the requested task.

Quick Start

Start by running donna -p llm -r <project-root> artifacts view '*:intro' to read the introduction and then run donna -p llm -r <project-root> sessions start to begin a new Donna session.

Frequently Asked Questions about donna-start

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

FAQPage Schema
How do I start a Donna session to run CLI workflows?

To start a Donna session, run the command `donna -p llm -r <project-root> sessions start` from your repository root, which initializes a managed context for subsequent workflow execution.

How do I load project artifacts before running an agent workflow?

Load project artifacts by executing `donna -p llm -r <project-root> artifacts view '*:intro'` to retrieve introductory context necessary before performing repository tasks.

What is a Donna session used for in software development?

A Donna session provides a managed context for agents to execute development workflows like running checks, formatting, or iterative development within a specific repository environment.

Do I need repository root access to initialize Donna workflows?

Yes, initializing Donna workflows requires access to the repository root and the ability to run donna CLI commands to create sessions and retrieve project artifacts.

When should I use Donna to manage agent development tasks?

Use Donna to manage agent tasks when a developer explicitly requests Donna workflows or when an agent must follow structured processes for checks, formatting, and iterative development.