{"id":"39d34a63-20d5-484c-9730-fd465bf5232b","entityType":"agent","slug":"clawhub-charlie-morrison-codebase-onboarder","name":"Codebase Onboarder","canonicalUrl":"https://www.xpersona.co/agent/clawhub-charlie-morrison-codebase-onboarder","canonicalPath":"/agent/clawhub-charlie-morrison-codebase-onboarder","generatedAt":"2026-10-11T01:45:48.172Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T23:01:51.754Z","emptyReason":null},"description":"AI-powered codebase analysis — generate architecture docs, onboarding guides, and key-flow walkthroughs for any project. Use when joining a new codebase, onb... Skill: Codebase Onboarder Owner: charlie-morrison Summary: AI-powered codebase analysis — generate architecture docs, onboarding guides, and key-flow walkthroughs for any project. Use when joining a new codebase, onb... Tags: latest:1.0.1 Version history: v1.0.1 | 2026-05-01T00:00:36.200Z | auto - No code or documentation changes in this release. - Version bump only; no user-facing changes. v1.0.0 | 2026-04-27T00:12:","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s17cttbdxry5kkyafjw983mq8s83p4y3:codebase-onboarder","sourceUrl":"https://clawhub.ai/charlie-morrison/codebase-onboarder","homepage":"https://clawhub.ai/charlie-morrison/skills/codebase-onboarder","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/charlie-morrison/codebase-onboarder","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/charlie-morrison/skills/codebase-onboarder","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":62,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"AI-powered codebase analysis — generate architecture docs, onboarding guides, and key-flow walkthroughs for any project. Use when joining a new codebase, onb..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T23:01:51.754Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T23:01:51.754Z","emptyReason":null},"stars":null,"forks":null,"downloads":1236,"packageName":null,"latestVersion":"1.0.1","tractionLabel":"1.2K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T23:01:51.698Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T23:01:51.754Z","lastCrawledAt":"2026-10-10T23:01:51.698Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T23:01:51.698Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.1","createdAt":"2026-05-01T00:00:36.200Z","changelog":"- No code or documentation changes in this release. - Version bump only; no user-facing changes.","fileCount":3,"zipByteSize":4365},{"version":"1.0.0","createdAt":"2026-04-27T00:12:01.037Z","changelog":"Initial release: AI-powered codebase analysis with structured onboarding guide output","fileCount":2,"zipByteSize":3276}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17cttbdxry5kkyafjw983mq8s83p4y3:codebase-onboarder","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-charlie-morrison-codebase-onboarder/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-charlie-morrison-codebase-onboarder/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-charlie-morrison-codebase-onboarder/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-charlie-morrison-codebase-onboarder/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-charlie-morrison-codebase-onboarder/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-charlie-morrison-codebase-onboarder/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T01:45:48.172Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-charlie-morrison-codebase-onboarder/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-charlie-morrison-codebase-onboarder/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-charlie-morrison-codebase-onboarder/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-charlie-morrison-codebase-onboarder/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T23:01:51.754Z","emptyReason":null},"readme":"Skill: Codebase Onboarder\n\nOwner: charlie-morrison\n\nSummary: AI-powered codebase analysis — generate architecture docs, onboarding guides, and key-flow walkthroughs for any project. Use when joining a new codebase, onb...\n\nTags: latest:1.0.1\n\nVersion history:\n\nv1.0.1 | 2026-05-01T00:00:36.200Z | auto\n\n- No code or documentation changes in this release.\n- Version bump only; no user-facing changes.\n\nv1.0.0 | 2026-04-27T00:12:01.037Z | user\n\nInitial release: AI-powered codebase analysis with structured onboarding guide output\n\nArchive index:\n\nArchive v1.0.1: 3 files, 4365 bytes\n\nFiles: skill-card.md (2012b), SKILL.md (6615b), _meta.json (137b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: codebase-onboarder\ndescription: AI-powered codebase analysis — generate architecture docs, onboarding guides, and key-flow walkthroughs for any project. Use when joining a new codebase, onboarding a team member, or documenting an undocumented project.\n---\n\n# Codebase Onboarder\n\nAnalyze any codebase and produce a structured onboarding guide. Covers architecture, key flows, patterns, dependencies, entry points, and gotchas — the things that take weeks to figure out by reading code.\n\nUse when: someone says \"help me understand this codebase\", \"onboard me\", \"document this project\", or \"what does this repo do\".\n\n## Analysis Steps\n\nRun these in order. Each step informs the next.\n\n### 1. Project Identity\n\n```bash\n# What is this?\ncat README.md 2>/dev/null || cat readme.md 2>/dev/null\ncat package.json 2>/dev/null | jq '{name, description, scripts}'\ncat pyproject.toml 2>/dev/null | head -30\ncat Cargo.toml 2>/dev/null | head -20\ncat go.mod 2>/dev/null | head -10\ncat Makefile 2>/dev/null | head -40\n```\n\nDetermine: language, framework, purpose, build system.\n\n### 2. Project Structure\n\n```bash\n# Directory tree (depth 3, ignore noise)\nfind . -maxdepth 3 -type d \\\n  -not -path '*/node_modules/*' \\\n  -not -path '*/.git/*' \\\n  -not -path '*/vendor/*' \\\n  -not -path '*/__pycache__/*' \\\n  -not -path '*/dist/*' \\\n  -not -path '*/build/*' \\\n  -not -path '*/.next/*' \\\n  -not -path '*/target/*' \\\n  | head -80\n\n# Count files by extension\nfind . -type f -not -path '*/node_modules/*' -not -path '*/.git/*' \\\n  | sed 's/.*\\.//' | sort | uniq -c | sort -rn | head -15\n```\n\nMap the architecture: where does business logic live, where are configs, where are tests, what's the convention.\n\n### 3. Entry Points\n\n```bash\n# Web apps\ngrep -rl \"listen\\|createServer\\|app\\.run\\|uvicorn\\|Flask(__name__)\" --include=\"*.{js,ts,py,go,rb}\" . 2>/dev/null | head -10\n\n# CLI tools\ngrep -rl \"if __name__\\|func main\\|fn main\\|bin.*:\" --include=\"*.{py,go,rs,json}\" . 2>/dev/null | head -10\n\n# Config-declared entry points\ncat package.json 2>/dev/null | jq '.main, .bin, .scripts.start, .scripts.dev'\ncat pyproject.toml 2>/dev/null | grep -A5 'scripts\\|entry_points'\n```\n\nIdentify: where does execution start, what are the main scripts/commands, how do you run it locally.\n\n### 4. Dependencies & Stack\n\n```bash\n# Key dependencies (not all — just the important ones)\ncat package.json 2>/dev/null | jq '.dependencies | keys' | head -20\ncat requirements.txt 2>/dev/null | head -20\ncat go.mod 2>/dev/null | grep -v '//' | tail -20\ncat Cargo.toml 2>/dev/null | grep -A50 '\\[dependencies\\]' | head -30\n```\n\nIdentify: database (postgres, mongo, redis), framework (express, fastapi, gin), ORM, auth, queue, cloud SDKs. These define the project's personality.\n\n### 5. Data Layer\n\n```bash\n# Database schemas, migrations, models\nfind . -type f \\( -name \"*.sql\" -o -name \"*migration*\" -o -name \"*schema*\" -o -name \"*model*\" \\) \\\n  -not -path '*/node_modules/*' 2>/dev/null | head -20\n\n# ORM models\ngrep -rl \"class.*Model\\|@Entity\\|schema\\.\\|CREATE TABLE\\|db\\.Column\" \\\n  --include=\"*.{py,ts,js,go,rb,java}\" . 2>/dev/null | head -10\n```\n\nMap: what are the core data entities, how are they related, where do migrations live.\n\n### 6. API Surface\n\n```bash\n# REST routes\ngrep -rn \"app\\.\\(get\\|post\\|put\\|delete\\|patch\\)\\|@app\\.route\\|router\\.\\(get\\|post\\)\\|@Get\\|@Post\\|@Controller\" \\\n  --include=\"*.{ts,js,py,go,rb,java}\" . 2>/dev/null | head -30\n\n# GraphQL\nfind . -name \"*.graphql\" -o -name \"*.gql\" -o -name \"*schema*\" -name \"*.graphql\" 2>/dev/null | head -10\ngrep -rl \"type Query\\|type Mutation\\|@Query\\|@Mutation\" --include=\"*.{ts,js,py,go}\" . 2>/dev/null | head -10\n```\n\nList the key endpoints/operations, grouped by domain.\n\n### 7. Config & Environment\n\n```bash\n# Environment variables\ncat .env.example 2>/dev/null || cat .env.sample 2>/dev/null || cat .env.template 2>/dev/null\ngrep -rh \"process\\.env\\.\\|os\\.environ\\|os\\.getenv\\|env::\\|std::env\" \\\n  --include=\"*.{ts,js,py,go,rs,rb}\" . 2>/dev/null | sort -u | head -30\n```\n\nDocument: what env vars are needed, which are secrets, what services need to be running.\n\n### 8. Testing\n\n```bash\n# Test structure\nfind . -type f \\( -name \"*test*\" -o -name \"*spec*\" -o -name \"*_test.*\" \\) \\\n  -not -path '*/node_modules/*' 2>/dev/null | head -20\n\n# How to run tests\ncat package.json 2>/dev/null | jq '.scripts.test'\ngrep -r \"pytest\\|jest\\|mocha\\|vitest\\|go test\\|cargo test\" Makefile* 2>/dev/null\n```\n\n### 9. CI/CD & Deployment\n\n```bash\nls -la .github/workflows/ 2>/dev/null\nls -la .gitlab-ci.yml 2>/dev/null\ncat Dockerfile 2>/dev/null | head -20\ncat docker-compose.yml 2>/dev/null | head -30\nls -la k8s/ kubernetes/ helm/ 2>/dev/null\n```\n\n## Output Template\n\nAfter analysis, produce a document with these sections:\n\n```markdown\n# [Project Name] — Onboarding Guide\n\n## What This Is\nOne paragraph: what it does, who it's for, what problem it solves.\n\n## Tech Stack\n- Language: X\n- Framework: X\n- Database: X\n- Key dependencies: X, Y, Z\n\n## Architecture\nDescribe the high-level architecture in 3-5 sentences. Include a simple diagram if helpful:\n- Monolith / microservices / serverless\n- Request flow: client → API → service → database\n- Key patterns: MVC, event-driven, CQRS, etc.\n\n## Directory Map\n| Path | Purpose |\n|------|---------|\n| src/api/ | REST endpoints |\n| src/services/ | Business logic |\n| src/models/ | Database models |\n| ... | ... |\n\n## Key Flows\nWalk through 2-3 critical user journeys:\n1. **User signup** — POST /auth/register → validate → hash password → insert user → send email → return token\n2. **Place order** — POST /orders → check inventory → charge payment → create order → notify warehouse\n\n## Getting Started\nStep-by-step: clone, install, configure env, seed database, run locally.\n\n## Gotchas\nThings that are non-obvious, surprising, or likely to trip someone up:\n- \"The auth middleware silently returns 200 on missing tokens (legacy behavior)\"\n- \"Tests require a running Redis instance on port 6380 (not default)\"\n- \"The migration in 0042 takes 20 minutes on large datasets\"\n\n## Where to Look\n| I want to... | Look at... |\n|--------------|-----------|\n| Add an API endpoint | src/api/routes/ |\n| Change the database schema | src/models/ + migrations/ |\n| Debug auth issues | src/middleware/auth.ts |\n| Understand the build | Makefile + .github/workflows/ |\n```\n\n## Tips\n\n- Read tests first — they document behavior better than comments\n- Check git log for the most-changed files — those are the hot paths\n- Look at recent PRs for coding conventions and review standards\n- If something is confusing, it's a gotcha worth documenting\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7d5eszdfwftk153ymhdm4qhs83qsqy\",\n  \"slug\": \"codebase-onboarder\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1777593636200\n}\n\nFile v1.0.1:skill-card.md\n\n## Description:\n\nAI-powered codebase analysis - generate architecture docs, onboarding guides, and key-flow walkthroughs for any project.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[charlie-morrison](https://clawhub.ai/user/charlie-morrison)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and engineers use this skill to analyze an unfamiliar repository and produce onboarding documentation covering architecture, key flows, dependencies, entry points, configuration, testing, deployment, and gotchas.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Repository summaries may include sensitive configuration details, environment names, or internal infrastructure information.\n\nMitigation: Review generated onboarding output before sharing it and redact any credentials or sensitive internal details.\n\nRisk: Generated architecture or workflow explanations may be incomplete or inaccurate for complex repositories.\n\nMitigation: Have a knowledgeable maintainer review the onboarding guide before relying on it for project decisions.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/charlie-morrison/skills/codebase-onboarder)\n- [Publisher profile](https://clawhub.ai/user/charlie-morrison)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, guidance]\n\n**Output Format:** [Markdown onboarding guide with tables and optional inline shell command examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [The output is intended for human review before sharing, especially sections that summarize configuration, environment variables, or internal infrastructure.]\n\n## Skill Version(s):\n\n1.0.1 (source: release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.0: 2 files, 3276 bytes\n\nFiles: SKILL.md (6615b), _meta.json (137b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: codebase-onboarder\ndescription: AI-powered codebase analysis — generate architecture docs, onboarding guides, and key-flow walkthroughs for any project. Use when joining a new codebase, onboarding a team member, or documenting an undocumented project.\n---\n\n# Codebase Onboarder\n\nAnalyze any codebase and produce a structured onboarding guide. Covers architecture, key flows, patterns, dependencies, entry points, and gotchas — the things that take weeks to figure out by reading code.\n\nUse when: someone says \"help me understand this codebase\", \"onboard me\", \"document this project\", or \"what does this repo do\".\n\n## Analysis Steps\n\nRun these in order. Each step informs the next.\n\n### 1. Project Identity\n\n```bash\n# What is this?\ncat README.md 2>/dev/null || cat readme.md 2>/dev/null\ncat package.json 2>/dev/null | jq '{name, description, scripts}'\ncat pyproject.toml 2>/dev/null | head -30\ncat Cargo.toml 2>/dev/null | head -20\ncat go.mod 2>/dev/null | head -10\ncat Makefile 2>/dev/null | head -40\n```\n\nDetermine: language, framework, purpose, build system.\n\n### 2. Project Structure\n\n```bash\n# Directory tree (depth 3, ignore noise)\nfind . -maxdepth 3 -type d \\\n  -not -path '*/node_modules/*' \\\n  -not -path '*/.git/*' \\\n  -not -path '*/vendor/*' \\\n  -not -path '*/__pycache__/*' \\\n  -not -path '*/dist/*' \\\n  -not -path '*/build/*' \\\n  -not -path '*/.next/*' \\\n  -not -path '*/target/*' \\\n  | head -80\n\n# Count files by extension\nfind . -type f -not -path '*/node_modules/*' -not -path '*/.git/*' \\\n  | sed 's/.*\\.//' | sort | uniq -c | sort -rn | head -15\n```\n\nMap the architecture: where does business logic live, where are configs, where are tests, what's the convention.\n\n### 3. Entry Points\n\n```bash\n# Web apps\ngrep -rl \"listen\\|createServer\\|app\\.run\\|uvicorn\\|Flask(__name__)\" --include=\"*.{js,ts,py,go,rb}\" . 2>/dev/null | head -10\n\n# CLI tools\ngrep -rl \"if __name__\\|func main\\|fn main\\|bin.*:\" --include=\"*.{py,go,rs,json}\" . 2>/dev/null | head -10\n\n# Config-declared entry points\ncat package.json 2>/dev/null | jq '.main, .bin, .scripts.start, .scripts.dev'\ncat pyproject.toml 2>/dev/null | grep -A5 'scripts\\|entry_points'\n```\n\nIdentify: where does execution start, what are the main scripts/commands, how do you run it locally.\n\n### 4. Dependencies & Stack\n\n```bash\n# Key dependencies (not all — just the important ones)\ncat package.json 2>/dev/null | jq '.dependencies | keys' | head -20\ncat requirements.txt 2>/dev/null | head -20\ncat go.mod 2>/dev/null | grep -v '//' | tail -20\ncat Cargo.toml 2>/dev/null | grep -A50 '\\[dependencies\\]' | head -30\n```\n\nIdentify: database (postgres, mongo, redis), framework (express, fastapi, gin), ORM, auth, queue, cloud SDKs. These define the project's personality.\n\n### 5. Data Layer\n\n```bash\n# Database schemas, migrations, models\nfind . -type f \\( -name \"*.sql\" -o -name \"*migration*\" -o -name \"*schema*\" -o -name \"*model*\" \\) \\\n  -not -path '*/node_modules/*' 2>/dev/null | head -20\n\n# ORM models\ngrep -rl \"class.*Model\\|@Entity\\|schema\\.\\|CREATE TABLE\\|db\\.Column\" \\\n  --include=\"*.{py,ts,js,go,rb,java}\" . 2>/dev/null | head -10\n```\n\nMap: what are the core data entities, how are they related, where do migrations live.\n\n### 6. API Surface\n\n```bash\n# REST routes\ngrep -rn \"app\\.\\(get\\|post\\|put\\|delete\\|patch\\)\\|@app\\.route\\|router\\.\\(get\\|post\\)\\|@Get\\|@Post\\|@Controller\" \\\n  --include=\"*.{ts,js,py,go,rb,java}\" . 2>/dev/null | head -30\n\n# GraphQL\nfind . -name \"*.graphql\" -o -name \"*.gql\" -o -name \"*schema*\" -name \"*.graphql\" 2>/dev/null | head -10\ngrep -rl \"type Query\\|type Mutation\\|@Query\\|@Mutation\" --include=\"*.{ts,js,py,go}\" . 2>/dev/null | head -10\n```\n\nList the key endpoints/operations, grouped by domain.\n\n### 7. Config & Environment\n\n```bash\n# Environment variables\ncat .env.example 2>/dev/null || cat .env.sample 2>/dev/null || cat .env.template 2>/dev/null\ngrep -rh \"process\\.env\\.\\|os\\.environ\\|os\\.getenv\\|env::\\|std::env\" \\\n  --include=\"*.{ts,js,py,go,rs,rb}\" . 2>/dev/null | sort -u | head -30\n```\n\nDocument: what env vars are needed, which are secrets, what services need to be running.\n\n### 8. Testing\n\n```bash\n# Test structure\nfind . -type f \\( -name \"*test*\" -o -name \"*spec*\" -o -name \"*_test.*\" \\) \\\n  -not -path '*/node_modules/*' 2>/dev/null | head -20\n\n# How to run tests\ncat package.json 2>/dev/null | jq '.scripts.test'\ngrep -r \"pytest\\|jest\\|mocha\\|vitest\\|go test\\|cargo test\" Makefile* 2>/dev/null\n```\n\n### 9. CI/CD & Deployment\n\n```bash\nls -la .github/workflows/ 2>/dev/null\nls -la .gitlab-ci.yml 2>/dev/null\ncat Dockerfile 2>/dev/null | head -20\ncat docker-compose.yml 2>/dev/null | head -30\nls -la k8s/ kubernetes/ helm/ 2>/dev/null\n```\n\n## Output Template\n\nAfter analysis, produce a document with these sections:\n\n```markdown\n# [Project Name] — Onboarding Guide\n\n## What This Is\nOne paragraph: what it does, who it's for, what problem it solves.\n\n## Tech Stack\n- Language: X\n- Framework: X\n- Database: X\n- Key dependencies: X, Y, Z\n\n## Architecture\nDescribe the high-level architecture in 3-5 sentences. Include a simple diagram if helpful:\n- Monolith / microservices / serverless\n- Request flow: client → API → service → database\n- Key patterns: MVC, event-driven, CQRS, etc.\n\n## Directory Map\n| Path | Purpose |\n|------|---------|\n| src/api/ | REST endpoints |\n| src/services/ | Business logic |\n| src/models/ | Database models |\n| ... | ... |\n\n## Key Flows\nWalk through 2-3 critical user journeys:\n1. **User signup** — POST /auth/register → validate → hash password → insert user → send email → return token\n2. **Place order** — POST /orders → check inventory → charge payment → create order → notify warehouse\n\n## Getting Started\nStep-by-step: clone, install, configure env, seed database, run locally.\n\n## Gotchas\nThings that are non-obvious, surprising, or likely to trip someone up:\n- \"The auth middleware silently returns 200 on missing tokens (legacy behavior)\"\n- \"Tests require a running Redis instance on port 6380 (not default)\"\n- \"The migration in 0042 takes 20 minutes on large datasets\"\n\n## Where to Look\n| I want to... | Look at... |\n|--------------|-----------|\n| Add an API endpoint | src/api/routes/ |\n| Change the database schema | src/models/ + migrations/ |\n| Debug auth issues | src/middleware/auth.ts |\n| Understand the build | Makefile + .github/workflows/ |\n```\n\n## Tips\n\n- Read tests first — they document behavior better than comments\n- Check git log for the most-changed files — those are the hot paths\n- Look at recent PRs for coding conventions and review standards\n- If something is confusing, it's a gotcha worth documenting\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7d5eszdfwftk153ymhdm4qhs83qsqy\",\n  \"slug\": \"codebase-onboarder\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1777248721037\n}","readmeExcerpt":"Skill: Codebase Onboarder Owner: charlie-morrison Summary: AI-powered codebase analysis — generate architecture docs, onboarding guides, and key-flow walkthroughs for any project. Use when joining a new codebase, onb... Tags: latest:1.0.1 Version history: v1.0.1 | 2026-05-01T00:00:36.200Z | auto - No code or documentation changes in this release. - Version bump only; no user-facing changes. v1.0.0 | 2026-04-27T00:12:","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# What is this?\ncat README.md 2>/dev/null || cat readme.md 2>/dev/null\ncat package.json 2>/dev/null | jq '{name, description, scripts}'\ncat pyproject.toml 2>/dev/null | head -30\ncat Cargo.toml 2>/dev/null | head -20\ncat go.mod 2>/dev/null | head -10\ncat Makefile 2>/dev/null | head -40"},{"language":"bash","snippet":"# Directory tree (depth 3, ignore noise)\nfind . -maxdepth 3 -type d \\\n  -not -path '*/node_modules/*' \\\n  -not -path '*/.git/*' \\\n  -not -path '*/vendor/*' \\\n  -not -path '*/__pycache__/*' \\\n  -not -path '*/dist/*' \\\n  -not -path '*/build/*' \\\n  -not -path '*/.next/*' \\\n  -not -path '*/target/*' \\\n  | head -80\n\n# Count files by extension\nfind . -type f -not -path '*/node_modules/*' -not -path '*/.git/*' \\\n  | sed 's/.*\\.//' | sort | uniq -c | sort -rn | head -15"},{"language":"bash","snippet":"# Web apps\ngrep -rl \"listen\\|createServer\\|app\\.run\\|uvicorn\\|Flask(__name__)\" --include=\"*.{js,ts,py,go,rb}\" . 2>/dev/null | head -10\n\n# CLI tools\ngrep -rl \"if __name__\\|func main\\|fn main\\|bin.*:\" --include=\"*.{py,go,rs,json}\" . 2>/dev/null | head -10\n\n# Config-declared entry points\ncat package.json 2>/dev/null | jq '.main, .bin, .scripts.start, .scripts.dev'\ncat pyproject.toml 2>/dev/null | grep -A5 'scripts\\|entry_points'"},{"language":"bash","snippet":"# Key dependencies (not all — just the important ones)\ncat package.json 2>/dev/null | jq '.dependencies | keys' | head -20\ncat requirements.txt 2>/dev/null | head -20\ncat go.mod 2>/dev/null | grep -v '//' | tail -20\ncat Cargo.toml 2>/dev/null | grep -A50 '\\[dependencies\\]' | head -30"},{"language":"bash","snippet":"# Database schemas, migrations, models\nfind . -type f \\( -name \"*.sql\" -o -name \"*migration*\" -o -name \"*schema*\" -o -name \"*model*\" \\) \\\n  -not -path '*/node_modules/*' 2>/dev/null | head -20\n\n# ORM models\ngrep -rl \"class.*Model\\|@Entity\\|schema\\.\\|CREATE TABLE\\|db\\.Column\" \\\n  --include=\"*.{py,ts,js,go,rb,java}\" . 2>/dev/null | head -10"},{"language":"bash","snippet":"# REST routes\ngrep -rn \"app\\.\\(get\\|post\\|put\\|delete\\|patch\\)\\|@app\\.route\\|router\\.\\(get\\|post\\)\\|@Get\\|@Post\\|@Controller\" \\\n  --include=\"*.{ts,js,py,go,rb,java}\" . 2>/dev/null | head -30\n\n# GraphQL\nfind . -name \"*.graphql\" -o -name \"*.gql\" -o -name \"*schema*\" -name \"*.graphql\" 2>/dev/null | head -10\ngrep -rl \"type Query\\|type Mutation\\|@Query\\|@Mutation\" --include=\"*.{ts,js,py,go}\" . 2>/dev/null | head -10"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: codebase-onboarder\ndescription: AI-powered codebase analysis — generate architecture docs, onboarding guides, and key-flow walkthroughs for any project. Use when joining a new codebase, onboarding a team member, or documenting an undocumented project.\n---\n\n# Codebase Onboarder\n\nAnalyze any codebase and produce a structured onboarding guide. Covers architecture, key flows, patterns, dependencies, entry points, and gotchas — the things that take weeks to figure out by reading code.\n\nUse when: someone says \"help me understand this codebase\", \"onboard me\", \"document this project\", or \"what does this repo do\".\n\n## Analysis Steps\n\nRun these in order. Each step informs the next.\n\n### 1. Project Identity\n\n```bash\n# What is this?\ncat README.md 2>/dev/null || cat readme.md 2>/dev/null\ncat package.json 2>/dev/null | jq '{name, description, scripts}'\ncat pyproject.toml 2>/dev/null | head -30\ncat Cargo.toml 2>/dev/null | head -20\ncat go.mod 2>/dev/null | head -10\ncat Makefile 2>/dev/null | head -40\n```\n\nDetermine: language, framework, purpose, build system.\n\n### 2. Project Structure\n\n```bash\n# Directory tree (depth 3, ignore noise)\nfind . -maxdepth 3 -type d \\\n  -not -path '*/node_modules/*' \\\n  -not -path '*/.git/*' \\\n  -not -path '*/vendor/*' \\\n  -not -path '*/__pycache__/*' \\\n  -not -path '*/dist/*' \\\n  -not -path '*/build/*' \\\n  -not -path '*/.next/*' \\\n  -not -path '*/target/*' \\\n  | head -80\n\n# Count files by extension\nfind . -type f -not -path '*/node_modules/*' -not -path '*/.git/*' \\\n  | sed 's/.*\\.//' | sort | uniq -c | sort -rn | head -15\n```\n\nMap the architecture: where does business logic live, where are configs, where are tests, what's the convention.\n\n### 3. Entry Points\n\n```bash\n# Web apps\ngrep -rl \"listen\\|createServer\\|app\\.run\\|uvicorn\\|Flask(__name__)\" --include=\"*.{js,ts,py,go,rb}\" . 2>/dev/null | head -10\n\n# CLI tools\ngrep -rl \"if __name__\\|func main\\|fn main\\|bin.*:\" --include=\"*.{py,go,rs,json}\" . 2>/dev/null | head -10\n\n# Config-declared entry points\ncat package.json 2>/dev/null | jq '.main, .bin, .scripts.start, .scripts.dev'\ncat pyproject.toml 2>/dev/null | grep -A5 'scripts\\|entry_points'\n```\n\nIdentify: where does execution start, what are the main scripts/commands, how do you run it locally.\n\n### 4. Dependencies & Stack\n\n```bash\n# Key dependencies (not all — just the important ones)\ncat package.json 2>/dev/null | jq '.dependencies | keys' | head -20\ncat requirements.txt 2>/dev/null | head -20\ncat go.mod 2>/dev/null | grep -v '//' | tail -20\ncat Cargo.toml 2>/dev/null | grep -A50 '\\[dependencies\\]' | head -30\n```\n\nIdentify: database (postgres, mongo, redis), framework (express, fastapi, gin), ORM, auth, queue, cloud SDKs. These define the project's personality.\n\n### 5. Data Layer\n\n```bash\n# Database schemas, migrations, models\nfind . -type f \\( -name \"*.sql\" -o -name \"*migration*\" -o -name \"*schema*\" -o -name \"*model*\" \\) \\\n  -not -path '*/node_modules/*' 2>/dev/null | head -20\n\n# ORM models\ngrep -rl \"class.*Model\\|@Entit"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7d5eszdfwftk153ymhdm4qhs83qsqy\",\n  \"slug\": \"codebase-onboarder\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1777593636200\n}"},{"path":"skill-card.md","content":"## Description:\n\nAI-powered codebase analysis - generate architecture docs, onboarding guides, and key-flow walkthroughs for any project.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[charlie-morrison](https://clawhub.ai/user/charlie-morrison)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and engineers use this skill to analyze an unfamiliar repository and produce onboarding documentation covering architecture, key flows, dependencies, entry points, configuration, testing, deployment, and gotchas.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Repository summaries may include sensitive configuration details, environment names, or internal infrastructure information.\n\nMitigation: Review generated onboarding output before sharing it and redact any credentials or sensitive internal details.\n\nRisk: Generated architecture or workflow explanations may be incomplete or inaccurate for complex repositories.\n\nMitigation: Have a knowledgeable maintainer review the onboarding guide before relying on it for project decisions.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/charlie-morrison/skills/codebase-onboarder)\n- [Publisher profile](https://clawhub.ai/user/charlie-morrison)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, guidance]\n\n**Output Format:** [Markdown onboarding guide with tables and optional inline shell command examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [The output is intended for human review before sharing, especially sections that summarize configuration, environment variables, or internal infrastructure.]\n\n## Skill Version(s):\n\n1.0.1 (source: release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"AI-powered codebase analysis — generate architecture docs, onboarding guides, and key-flow walkthroughs for any project. Use when joining a new codebase, onb... Skill: Codebase Onboarder Owner: charlie-morrison Summary: AI-powered codebase analysis — generate architecture docs, onboarding guides, and key-flow walkthroughs for any project. Use when joining a new codebase, onb... Tags: latest:1.0.1 Version history: v1.0.1 | 2026-05-01T00:00:36.200Z | auto - No code or documentation changes in this release. - Version bump only; no user-facing changes. v1.0.0 | 2026-04-27T00:12:","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":840,"uniquenessScore":58,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T23:01:51.754Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T23:01:51.754Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T01:45:48.172Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}