All skills
oaustegard avatar

/exploring-codebases

@5e58100

First-encounter orientation on a repository nobody here has worked in yet. Runs a fixed five-step workflow — venv setup, tarball fetch, tree-sitting structural scan, featuring synthesis, then reasoning over the two — and yields an account of what the repo contains and how it is arranged, optionally written out as _FEATURES.md. Use for "I just cloned this", "what is this repo", "what does this do", "explore this repo", "give me an orientation", "what are the main features", "review what's new in this repo", or before starting work in a codebase you have not seen. This is the divergent what's-here skill. Route elsewhere for: a named symbol, a file's structure or a line range (tree-sitting); all callers of a Python symbol (searching-codebases); teaching a human the codebase through exercises (orienting-codebases); fetching or cloning a repo without analysing it (accessing-github-repos, cloning-project).

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

This session only. Nothing lands on disk.

README.md

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

exploring-codebases

Semantic search for codebases. Locates matches with ripgrep and expands them into full AST nodes (functions/classes) using tree-sitter. Returns complete, syntactically valid code blocks rather than fragmented lines. Use when looking for specific implementations, examples, or references where full context is needed.

Source: SKILL.md on GitHub

2 warnings14d4 checks · Risk SAFE
  • Gen Agent Trust Hub14d

    This skill allows an AI agent to explore new codebases by downloading them from GitHub and performing structural analysis. It is designed to help the agent orient itself in unfamiliar repositories. The security profile is generally safe as it uses trusted sources, but there is an inherent risk of indirect prompt injection because the agent is tasked with processing and reasoning over untrusted external code.

  • Socket14d

    No alerts

  • Snyk14d

    Risk: MEDIUM · 1 issue

  • Runlayer7mo

    7/7 files flagged

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

Last checked against GitHub yesterday.

Activeupdated 3 weeks ago
metadata
{
  "version": "2.5.2"
}

README badge

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