skilld
All skills
oaustegard avatar

/orienting-codebases

@04bfd5b
by Oskar Austegardoaustegard/claude-skills150 stars
6

Interactive codebase orientation for a HUMAN who wants to learn the code. Runs the same tree-sitting + featuring pipeline as exploring-codebases but synthesizes it into guided exercises and an HTML teaching artifact rather than an analysis document. Use for "orient me to this repo", "teach me this codebase", "walk me through this code", "learning orientation", or when someone wants genuine comprehension rather than a task completed. The audience is the test: if nobody is being taught and the goal is to get work done, use exploring-codebases instead.

Ask your Agent

Use this Skill: https://skilld.dev/gh/oaustegard/claude-skills/orienting-codebases

This session only. Nothing lands on disk.

CHANGELOG.md

≈254 tokens on demand. Your agent reads this file only when SKILL.md points to it.

orienting-codebases - Changelog

All notable changes to the orienting-codebases skill are documented in this file. The format is based on Keep a Changelog.

[0.4.0] - 2026-08-25

Other

  • top skills: separate by omission, and correct the guidance that said otherwise (#777)

[0.3.0] - 2026-05-12

Other

  • orienting-codebases: extract human-facing rationale to README (#642)

[0.3.0] - 2026-05-12

Changed

  • Cut human-facing rationale from SKILL.md (Why this exists, Why HTML, Principles reference). Inlined one operational directive about <details> enforcement near the artifact template. SKILL.md now opens with a one-line positioning sentence and goes straight to Pipeline, matching the sibling exploring-codebases pattern.

Added

  • README.md hosting the rationale, design notes, and pedagogical principles citations that were cut from SKILL.md.

[0.2.0] - 2026-05-12

Added

  • add orienting-codebases skill (#641)

Source: SKILL.md on GitHub

Third-party checks

1 warning9d3 checks · Risk SAFE
  • Gen Agent Trust Hub9d

    This skill facilitates interactive codebase orientation for users by generating guided HTML exercises. It uses standard tools to download repository content from GitHub, analyze its structure, and present relevant code snippets in a pedagogical format. The operations performed are consistent with its stated purpose and follow safe development practices.

  • Socket3mo

    No alerts

  • Snyk9d

    Risk: MEDIUM · 1 issue

Provenance

Signed by skilld at 04bfd5b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last month

Capability

Other metadata
metadata
{
  "version": "0.4.0",
  "license": "CC-BY-4.0",
  "lineage": "Pedagogical design adapted from DrCatHicks/learning-opportunities (orient skill + PRINCIPLES.md). Pipeline from exploring-codebases. Presentation via composing-html."
}

README badge

README badge for oaustegard/claude-skills/orienting-codebases