Agent skill

Project Structure Overview

by skuramatata in skuramatata/my-pi-agent

A skill your agent uses when a request in the my-pi-agent repository needs a fast codebase overview before implementation or review: 项目结构速览、代码仓概览、目录地图、先看项目、架构入口梳理、模块边界确认、相关文件定位。

No licenceAuto-check passedDevelopment

Install Project Structure Overview

skills CLI
$ npx skills add skuramatata/my-pi-agent --skill project-structure-overview -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install skuramatata/my-pi-agent project-structure-overview --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/skuramatata/my-pi-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/project-structure-overview .claude/skills/project-structure-overview && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
project-structure-overview
GitHub stars
114
Token cost
~1.1k tokens
SKILL.md length
439 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when a request in the my-pi-agent repository needs a fast codebase overview before implementation or review: 项目结构速览、代码仓概览、目录地图、先看项目、架构入口梳理、模块边界确认、相关文件定位。

  • Works in 4 steps: Start from the high-signal surface. → Identify ownership. → Summarize only the task-relevant area. → …
  • A request in the my-pi-agent repository needs a fast codebase overview before implementation
  • SKILL.md covers Workflow, Routing Map, Output Contract and Guardrails
  • Calls rg

What it does

Project Structure Overview is an agent skill from skuramatata/my-pi-agent. Use when a request in the my-pi-agent repository needs a fast codebase overview before implementation or review: 项目结构速览、代码仓概览、目录地图、先看项目、架构入口梳理、模块边界确认、相关文件定位。

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Codebase onboarding.

When your agent uses it

  • A request in the my-pi-agent repository needs a fast codebase overview before implementation
  • Review: 项目结构速览、代码仓概览、目录地图、先看项目、架构入口梳理、模块边界确认、相关文件定位

Example prompts

  • “/project-structure-overview”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Start from the high-signal surface.
  2. Identify ownership.
  3. Summarize only the task-relevant area.
  4. End with a working map.

What it can do on your machine

Read from SKILL.md and the folder at commit ed83ff1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • rg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Project Structure Overview loads about 1.1k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 439 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 439 words (~1,146 tokens).

“Use this skill to build a compact mental model of my-pi-agent before planning, coding, reviewing, or debugging.”

— opening of SKILL.md by skuramatata
name
project-structure-overview

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .opencode/skills/project-structure-overview of skuramatata/my-pi-agent.

Open the folder on GitHubat commit ed83ff1

Compare with similar skills

Project Structure Overview next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Project Structure Overview compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Structure Overview this skillskuramatata/my-pi-agent114—~1.1kAutomated safety check: PassNone
Codebase Knowledge Graph Q&AEgonex-AI/Understand-Anything86k—~1.2kAutomated safety check: PassMIT
Understand ExplainEgonex-AI/Understand-Anything86k—~1.3kAutomated safety check: PassMIT
Project Onboarding Guide from Knowledge GraphEgonex-AI/Understand-Anything86k—~1.2kAutomated safety check: PassMIT
GitDiagram Repository Overviewahmedkhaleel2004/gitdiagram18k—~427Automated safety check: PassMIT
Deepwiki Rssopaco/deepwiki-rs3.1k—~748Automated safety check: PassMIT

Similar skills

  • Codebase Knowledge Graph Q&A

    Egonex-AI/Understand-Anything

    Answers questions about a codebase by searching a prebuilt knowledge graph of its files, functions, classes and dependencies, not by rereading every source file.

    86k GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Understand Explain

    Egonex-AI/Understand-Anything

    Gives an in-depth explanation of one file, function or module by reading the project's knowledge graph and checking that the graph is still fresh.

    86k GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Writes an onboarding guide for new team members from a project's existing knowledge graph, after checking that the graph still matches the current commit.

    86k GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • GitDiagram Repository Overview

    ahmedkhaleel2004/gitdiagram

    Explains the architecture of a public GitHub repository through GitDiagram: how the code is organized, the main components with paths, and a Mermaid diagram.

    18k GitHub stars~427 tokensUpdated today
    DevelopmentAuto-check passed
  • Deepwiki Rs

    sopaco/deepwiki-rs

    AI-powered Rust documentation generation engine for comprehensive codebase analysis, C4 architecture diagrams, and automated technical documentation.

    3.1k GitHub stars~748 tokensUpdated 26 days ago
    DevelopmentAuto-check passed
  • Explore Codebase with Graph

    tirth8205/code-review-graph

    Navigates a codebase through the code-review-graph MCP tools: architecture overview, symbol search, caller and callee tracing, flows and oversized functions.

    32k GitHub starsUsed in 1 repo~335 tokens
    DevelopmentAuto-check passed

More from skuramatata/my-pi-agent

All 24 skills in this repo
  • Documentation And Adrs

    skuramatata/my-pi-agent

    A skill your agent uses when my-pi-agent changes architecture, runtime/workflow/executor behavior, prompt-engine contracts, memory/state, channel behavior, MCP/OpenCode config, README content, or…

    114 GitHub stars~588 tokensUpdated 3 mo ago
    Auto-check passed
  • Documentation And Adrs

    skuramatata/my-pi-agent

    A skill your agent uses when my-pi-agent changes architecture, orchestration, execution, prompt-engine, memory, Feishu/channel behavior, skill scope, verifier semantics, public commands, or…

    114 GitHub stars~635 tokensUpdated 3 mo ago
    Auto-check passed
  • Openspec Apply Change

    skuramatata/my-pi-agent

    A skill your agent uses when the user wants to implement, continue, or work through tasks from an existing OpenSpec change.

    114 GitHub stars~433 tokensUpdated 3 mo ago
    Auto-check passed
  • Openspec Propose

    skuramatata/my-pi-agent

    A skill your agent uses when the user wants to propose a new OpenSpec change and generate proposal, design, specs, and tasks before implementation.

    114 GitHub stars~351 tokensUpdated 3 mo ago
    Auto-check passed
  • Code Review

    skuramatata/my-pi-agent

    A skill your agent uses when reviewing a my-pi-agent change before merge or handoff: 代码审查、review、PR review、改动盘点、merge readiness、风险找漏、提交前质量检查。

    114 GitHub stars~596 tokensUpdated 3 mo ago
    Auto-check passed
  • Code Review And Quality

    skuramatata/my-pi-agent

    A skill your agent uses when reviewing my-pi-agent changes, PRs, worker output, verifier repair results, prompt/skill edits, Feishu channel changes, or shared runtime refactors.

    114 GitHub stars~777 tokensUpdated 3 mo ago
    Auto-check: notes

Categories

Questions about Project Structure Overview

What does Project Structure Overview do?

A skill your agent uses when a request in the my-pi-agent repository needs a fast codebase overview before implementation or review: 项目结构速览、代码仓概览、目录地图、先看项目、架构入口梳理、模块边界确认、相关文件定位。. Project Structure Overview is an agent skill from skuramatata/my-pi-agent.

When should I use Project Structure Overview?

Project Structure Overview fits situations like: A request in the my-pi-agent repository needs a fast codebase overview before implementation; review: 项目结构速览、代码仓概览、目录地图、先看项目、架构入口梳理、模块边界确认、相关文件定位.

How do I install Project Structure Overview in Claude Code?

Run `npx skills add skuramatata/my-pi-agent --skill project-structure-overview -a claude-code`. Or copy the skill folder (.opencode/skills/project-structure-overview in skuramatata/my-pi-agent) into .claude/skills/project-structure-overview in your project. Claude Code loads it when a task matches its description.

How do I install Project Structure Overview in Codex?

Run `npx skills add skuramatata/my-pi-agent --skill project-structure-overview -a codex`. Or copy the skill folder (.opencode/skills/project-structure-overview in skuramatata/my-pi-agent) into .agents/skills/project-structure-overview in your project. Codex loads it when a task matches its description.

Can I use Project Structure Overview in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add skuramatata/my-pi-agent --skill project-structure-overview -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-structure-overview, .gemini/skills/project-structure-overview, .github/skills/project-structure-overview and .opencode/skills/project-structure-overview in your project.

What does Project Structure Overview need to run?

Going by SKILL.md and its folder, Project Structure Overview needs the command-line tools its instructions call (rg).

Does Project Structure Overview access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Project Structure Overview safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Project Structure Overview use?

No licence was found for Project Structure Overview or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Project Structure Overview use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Project Structure Overview?

Skills that share tags, products or a category with Project Structure Overview: Codebase Knowledge Graph Q&A (Egonex-AI/Understand-Anything, 86k stars), Understand Explain (Egonex-AI/Understand-Anything, 86k stars), Project Onboarding Guide from Knowledge Graph (Egonex-AI/Understand-Anything, 86k stars) and GitDiagram Repository Overview (ahmedkhaleel2004/gitdiagram, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Structure Overview?

skuramatata (a GitHub user) maintains it in skuramatata/my-pi-agent, which has 114 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on July 10, 2026.

Source: skuramatata/my-pi-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.