harness-onboarding

Generate ONBOARDING.md from HARNESS.md, AGENTS.md, and REFLECTION_LOG.md.

44|6|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Habitat-Thinking/ai-literacy-superpowers --skill harness-onboarding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-onboarding
Source: https://github.com/Habitat-Thinking/ai-literacy-superpowers/tree/main/ai-literacy-superpowers/skills/harness-onboarding
Command: npx skills add https://github.com/Habitat-Thinking/ai-literacy-superpowers --skill harness-onboarding

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translate machine-oriented harness, agent, and reflection files into a concise, human-friendly ONBOARDING.md so new contributors can ramp up quickly without parsing constraints or GC rules.

Core Features & Use Cases

  • Automated synthesis of ONBOARDING.md from HARNESS.md, AGENTS.md, and REFLECTION_LOG.md that preserves authoritative sources while producing readable guidance.
  • Validation against templates/ONBOARDING.md to ensure all required sections are present and automatically fix missing sections.
  • Use case: Provide a new developer with a clear tech stack summary, how-we-write-code guidance, a first-PR checklist, common pitfalls, and architecture decisions derived from existing project artifacts.

Quick Start

Run the harness-onboarding skill to synthesize ONBOARDING.md from HARNESS.md, AGENTS.md, and REFLECTION_LOG.md and validate that all required sections are present.

Frequently Asked Questions about harness-onboarding

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

FAQPage Schema
How do I generate onboarding documentation from harness and agent files?

Generate onboarding documentation by running the harness-onboarding skill to synthesize HARNESS.md, AGENTS.md, and REFLECTION_LOG.md into a human-readable ONBOARDING.md. It automatically extracts tech stack summaries, architecture decisions, and first-PR checklists for new developers.

What is the best way to create a first-PR checklist for new developers?

The best way to create a first-PR checklist is to synthesize existing project artifacts using harness-onboarding. It reads reflection logs and agent architecture notes to automatically produce validated onboarding guidance with common pitfalls and constraints grouped by enforcement timing.

How do I validate that my ONBOARDING.md contains all required sections?

Validate your ONBOARDING.md by checking it against the templates/ONBOARDING.md section structure. The harness-onboarding skill performs this validation automatically, fixes missing sections, and flags staleness whenever source files are newer than the generated document.

Can I use harness files and reflection logs to onboard new contributors automatically?

Yes, you can use harness files and reflection logs to onboard new contributors automatically. The harness-onboarding skill translates machine-oriented constraints and GC rules from these files into concise, human-friendly guidance without requiring manual parsing.

Why does my generated onboarding document show a staleness flag?

Your generated onboarding document shows a staleness flag because source files like HARNESS.md or REFLECTION_LOG.md have been updated more recently than ONBOARDING.md. This indicates the onboarding guidance is outdated and needs to be regenerated to reflect current project constraints.

Does harness onboarding work for repositories without agent architecture notes?

Harness onboarding is designed for repositories that use a harnessed workflow, agent architecture notes, and reflection logs. Without AGENTS.md, the skill cannot extract architecture decisions and common pitfalls, reducing the completeness of the synthesized ONBOARDING.md.