brynhild-development

Provide development guidelines for contributing to the Brynhild codebase.

Updated Dec 1, 2025
One-click install
npx skills add https://github.com/mandersogit/brynhild-harness --skill brynhild-development
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brynhild-development
Source: https://github.com/mandersogit/brynhild-harness/tree/main/.brynhild/skills/brynhild-development
Command: npx skills add https://github.com/mandersogit/brynhild-harness --skill brynhild-development

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guidelines for contributing to Brynhild itself, including running tests, code conventions, and project structure. Ideal for developers who want to contribute changes.

Core Features & Use Cases

  • Project venv usage, environment setup, and development commands
  • Testing, type checking, and linting guidelines
  • Code formatting and import style conventions
  • Documenting project structure and best practices

Quick Start

Review the development guidelines in this skill to learn how to contribute, run tests, and maintain Brynhild’s quality.

Frequently Asked Questions about brynhild-development

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

FAQPage Schema
How do I set up a development environment for contributing to Brynhild?

Set up a development environment by creating and activating a Python virtual environment within the project, avoiding system Python. Install dependencies, then run pytest for testing, mypy or pyright for type checking, and ruff for linting to maintain code quality.

What are the code conventions and import style guidelines for Brynhild contributions?

Brynhild enforces qualified imports and specific code formatting standards. Use ruff for linting compliance, follow the documented import style conventions, and ensure all code adheres to the project's type-checking requirements before committing.

How do I run tests and type checks for Brynhild code changes?

Run pytest to execute the test suite, then run mypy or pyright for type checking to catch static errors. Both checks must pass before submitting changes. Use ruff to lint your code and ensure it meets formatting standards.

What's the proper workflow for committing changes to Brynhild?

Use the commit-helper workflow to structure and submit commits. This ensures commits follow project conventions, pass all checks, and maintain consistency across the codebase before merging.

Where do I add or edit skills in the Brynhild repository?

Skills are stored and managed in the `.brynhild/skills` directory. Follow the project structure, apply all code conventions, and run the full test and type-checking suite before committing skill additions or edits.

Do I need to avoid using system Python when developing Brynhild?

Yes, you must use a project virtual environment and avoid system Python. The project requires an isolated venv to ensure consistent dependencies and prevent environment-related issues during development and testing.