pharaoh-author

Create or update sphinx-needs directives with schema-validated IDs, types, and links.

24|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/patdhlk/pharaoh --skill pharaoh-author
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pharaoh-author
Source: https://github.com/patdhlk/pharaoh/tree/main/skills/pharaoh-author
Command: npx skills add https://github.com/patdhlk/pharaoh --skill pharaoh-author

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Authoring and modifying sphinx-needs directives can be error-prone due to strict IDs, type constraints, and complex link rules; this skill provides automated guidance to enforce project schemas during authoring.

Core Features & Use Cases

  • Enforces correct RST syntax for needs directives and validates IDs, types, and link constraints against project configuration.
  • Checks and propagates required attributes (ids, statuses, tags, links, extra options) and ensures valid inter-need relationships.
  • Supports both advisory and strict modes, gating changes on change analysis when required, and integrates with the pharaoh workflow (change -> author -> verify -> release).

Quick Start

Write a new or modify an existing sphinx-needs directive by providing the need type, title, and links; the AI will enforce IDs and schema compliance during authoring.

Frequently Asked Questions about pharaoh-author

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

FAQPage Schema
How do I validate sphinx-needs directive IDs and types against my project schema?

To validate sphinx-needs directives, you can use schema-aware authoring to check IDs, types, and link constraints against your project configuration. This skill enforces correct RST syntax and propagates required attributes during the authoring process.

How do I create properly formatted sphinx-needs directives with correct attributes?

Creating properly formatted sphinx-needs directives requires providing the need type, title, and links. The skill generates correctly formatted RST directives with proper attributes and updates session state to reflect the authored changes automatically.

What is the difference between advisory and strict modes in sphinx-needs authoring?

Advisory and strict modes in sphinx-needs authoring control validation enforcement. Strict mode gates changes on mandatory change analyses when required, while advisory mode provides automated guidance without blocking the authoring workflow.

Can I integrate sphinx-needs authoring with a continuous change and release workflow?

Yes, sphinx-needs authoring integrates with the pharaoh workflow, connecting change, author, verify, and release stages. This ensures traceability and schema compliance throughout the entire software engineering lifecycle.

Why does my sphinx-needs directive fail validation due to incorrect link rules?

Sphinx-needs directive validation fails when link rules are violated due to complex inter-need relationships. Schema-aware authoring enforces these constraints, checking and propagating valid statuses, tags, and links to prevent configuration errors.