{"id":"af018cfc-0187-47eb-9ffb-e43c84c62983","entityType":"agent","slug":"clawhub-builtbyecho-repo-agent-brief","name":"repo-agent-brief","canonicalUrl":"https://www.xpersona.co/agent/clawhub-builtbyecho-repo-agent-brief","canonicalPath":"/agent/clawhub-builtbyecho-repo-agent-brief","generatedAt":"2026-10-11T20:57:56.352Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T17:04:28.781Z","emptyReason":null},"description":"Generate concise, safety-aware repository orientation briefs with @builtbyecho/repo-agent-brief/agent-brief before coding-agent work, reviews, handoffs, PR a... Skill: repo-agent-brief Owner: builtbyecho Summary: Generate concise, safety-aware repository orientation briefs with @builtbyecho/repo-agent-brief/agent-brief before coding-agent work, reviews, handoffs, PR a... Tags: agent-tools:0.2.1, builtbyecho:0.2.1, handoffs:0.2.1, latest:0.4.1 Version history: v0.4.1 | 2026-05-27T23:58:10.353Z | user Prefer canonical scoped npm package @builtbyecho/repo-agent-brief v0.2.3 | 2","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s1719nva0zh5vbbjbpa8vf7nhx85jdr1:repo-agent-brief","sourceUrl":"https://clawhub.ai/builtbyecho/repo-agent-brief","homepage":"https://clawhub.ai/builtbyecho/skills/repo-agent-brief","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/builtbyecho/repo-agent-brief","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/builtbyecho/skills/repo-agent-brief","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Generate concise, safety-aware repository orientation briefs with @builtbyecho/repo-agent-brief/agent-brief before coding-agent work, reviews, handoffs, PR a..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:04:28.781Z","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-11T17:04:28.781Z","emptyReason":null},"stars":null,"forks":null,"downloads":1022,"packageName":null,"latestVersion":"0.4.1","tractionLabel":"1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:04:28.702Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T17:04:28.781Z","lastCrawledAt":"2026-10-11T17:04:28.702Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T17:04:28.702Z","lastVerifiedAt":null,"highlights":[{"version":"0.4.1","createdAt":"2026-05-27T23:58:10.353Z","changelog":"Prefer canonical scoped npm package @builtbyecho/repo-agent-brief","fileCount":3,"zipByteSize":2364},{"version":"0.2.3","createdAt":"2026-05-14T21:01:33.876Z","changelog":"Add Vaultline handoff artifact upload workflow","fileCount":3,"zipByteSize":2769},{"version":"0.2.2","createdAt":"2026-05-14T19:17:25.845Z","changelog":"Workspace publish pass","fileCount":2,"zipByteSize":1145},{"version":"0.2.1","createdAt":"2026-05-10T18:02:53.375Z","changelog":"Initial ClawHub publish for the BuiltByEcho repo orientation and handoff brief workflow.","fileCount":2,"zipByteSize":1145}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1719nva0zh5vbbjbpa8vf7nhx85jdr1:repo-agent-brief","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-builtbyecho-repo-agent-brief/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-builtbyecho-repo-agent-brief/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-builtbyecho-repo-agent-brief/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-builtbyecho-repo-agent-brief/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-builtbyecho-repo-agent-brief/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-builtbyecho-repo-agent-brief/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-11T20:57:56.352Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-builtbyecho-repo-agent-brief/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-builtbyecho-repo-agent-brief/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-builtbyecho-repo-agent-brief/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-builtbyecho-repo-agent-brief/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-11T17:04:28.781Z","emptyReason":null},"readme":"Skill: repo-agent-brief\n\nOwner: builtbyecho\n\nSummary: Generate concise, safety-aware repository orientation briefs with @builtbyecho/repo-agent-brief/agent-brief before coding-agent work, reviews, handoffs, PR a...\n\nTags: agent-tools:0.2.1, builtbyecho:0.2.1, handoffs:0.2.1, latest:0.4.1\n\nVersion history:\n\nv0.4.1 | 2026-05-27T23:58:10.353Z | user\n\nPrefer canonical scoped npm package @builtbyecho/repo-agent-brief\n\nv0.2.3 | 2026-05-14T21:01:33.876Z | user\n\nAdd Vaultline handoff artifact upload workflow\n\nv0.2.2 | 2026-05-14T19:17:25.845Z | user\n\nWorkspace publish pass\n\nv0.2.1 | 2026-05-10T18:02:53.375Z | user\n\nInitial ClawHub publish for the BuiltByEcho repo orientation and handoff brief workflow.\n\nArchive index:\n\nArchive v0.4.1: 3 files, 2364 bytes\n\nFiles: skill-card.md (2033b), SKILL.md (2029b), _meta.json (135b)\n\nFile v0.4.1:SKILL.md\n\n---\nname: repo-agent-brief\ndescription: Generate concise, safety-aware repository orientation briefs with @builtbyecho/repo-agent-brief/agent-brief before coding-agent work, reviews, handoffs, PR analysis, unfamiliar repo edits, diff-aware branch handoffs, or when an agent needs stack/commands/context/risk signals before changing files.\n---\n\n# Repo Agent Brief Skill\n\nUse `@builtbyecho/repo-agent-brief` to orient an agent before it edits or reviews a repository. It finds high-signal context files, infers stack/commands, builds a compact repo map, and flags obvious secret/risky-instruction patterns.\n\n## Default workflow\n\nFrom the repository root:\n\n```bash\nnpx @builtbyecho/repo-agent-brief . > AGENT_BRIEF.md\nsed -n '1,220p' AGENT_BRIEF.md\n```\n\nFor in-progress branches:\n\n```bash\nnpx @builtbyecho/repo-agent-brief . --diff origin/main > AGENT_HANDOFF.md\nsed -n '1,260p' AGENT_HANDOFF.md\n```\n\nFor machine-readable automation:\n\n```bash\nnpx @builtbyecho/repo-agent-brief . --format json > agent-brief.json\n```\n\nFor durable handoffs:\n\n```bash\nnpx @builtbyecho/repo-agent-brief . --diff HEAD --bundle\nsed -n '1,220p' .agent-brief/brief.md\nsed -n '1,160p' .agent-brief/verification.md\n```\n\n## When to use\n\n- First pass in an unfamiliar repo.\n- Before delegating to a coding agent.\n- PR/branch handoff where changed files matter.\n- Safety preflight before touching CI, migrations, deploy scripts, auth, or config.\n\n## Safety\n\n- This is not a full secret scanner. Use Gitleaks/TruffleHog for full audits.\n- If high-risk patterns are found, inspect before proceeding.\n- Use `--fail-on-high-risk` in CI or strict agent workflows.\n- Generated briefs may include snippets from repo context files; avoid posting publicly without review.\n\n## Useful commands\n\n```bash\nnpx @builtbyecho/repo-agent-brief .\nnpx @builtbyecho/repo-agent-brief . --diff HEAD\nnpx @builtbyecho/repo-agent-brief . --diff HEAD --bundle\nnpx @builtbyecho/repo-agent-brief . --diff origin/main --fail-on-high-risk\nnpx @builtbyecho/repo-agent-brief . --no-snippets\n```\n\nFile v0.4.1:_meta.json\n\n{\n \"ownerId\": \"kn788ycwjjfc27w9rytz2e7wxs85jnzh\",\n \"slug\": \"repo-agent-brief\",\n \"version\": \"0.4.1\",\n \"publishedAt\": 1779926290353\n}\n\nFile v0.4.1:skill-card.md\n\n## Description:\n\nGenerates concise, safety-aware repository orientation briefs before coding-agent work, reviews, handoffs, PR analysis, unfamiliar repository edits, or diff-aware branch handoffs.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[builtbyecho](https://clawhub.ai/user/builtbyecho)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and coding agents use this skill to gather repository orientation before edits, reviews, handoffs, pull request analysis, or safety-sensitive changes. It helps identify high-signal context files, stack and command hints, repository structure, and obvious risky-instruction or secret-pattern signals.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill directs users to run an unpinned third-party npm package inside repositories that may contain sensitive code or configuration.\n\nMitigation: Use a pinned, reviewed version of @builtbyecho/repo-agent-brief and run it with minimal repository credentials.\n\nRisk: Generated briefs may include snippets from repository context files.\n\nMitigation: Review generated briefs before sharing them and use --no-snippets when public or broad distribution is expected.\n\n## Reference(s):\n\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown with inline shell commands; JSON is available when the underlying package is run with --format json]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May write repository brief files such as AGENT_BRIEF.md, AGENT_HANDOFF.md, agent-brief.json, or .agent-brief bundle files depending on the selected command.]\n\n## Skill Version(s):\n\n0.4.1 (source: server release metadata)\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 v0.2.3: 3 files, 2769 bytes\n\nFiles: skill-card.md (2413b), SKILL.md (2367b), _meta.json (135b)\n\nFile v0.2.3:SKILL.md\n\n---\nname: repo-agent-brief\ndescription: Generate concise, safety-aware repository orientation briefs with repo-agent-brief/agent-brief before coding-agent work, reviews, handoffs, PR analysis, unfamiliar repo edits, diff-aware branch handoffs, or when an agent needs stack/commands/context/risk signals before changing files.\n---\n\n# Repo Agent Brief Skill\n\nUse `repo-agent-brief` to orient an agent before it edits or reviews a repository. It finds high-signal context files, infers stack/commands, builds a compact repo map, and flags obvious secret/risky-instruction patterns.\n\n## Default workflow\n\nFrom the repository root:\n\n```bash\nnpx repo-agent-brief . > AGENT_BRIEF.md\nsed -n '1,220p' AGENT_BRIEF.md\n```\n\nFor in-progress branches:\n\n```bash\nnpx repo-agent-brief . --diff origin/main > AGENT_HANDOFF.md\nsed -n '1,260p' AGENT_HANDOFF.md\n```\n\nFor machine-readable automation:\n\n```bash\nnpx repo-agent-brief . --format json > agent-brief.json\n```\n\n## When to use\n\n- First pass in an unfamiliar repo.\n- Before delegating to a coding agent.\n- PR/branch handoff where changed files matter.\n- Safety preflight before touching CI, migrations, deploy scripts, auth, or config.\n\n## Safety\n\n- This is not a full secret scanner. Use Gitleaks/TruffleHog for full audits.\n- If high-risk patterns are found, inspect before proceeding.\n- Use `--fail-on-high-risk` in CI or strict agent workflows.\n- Generated briefs may include snippets from repo context files; avoid posting publicly without review.\n\n## Useful commands\n\n```bash\nnpx repo-agent-brief .\nnpx repo-agent-brief . --diff HEAD\nnpx repo-agent-brief . --diff origin/main --fail-on-high-risk\nnpx repo-agent-brief . --no-snippets\n```\n\n## Vaultline integration\n\nIf the brief is for multi-agent or human handoff, upload `AGENT_BRIEF.md` to Vaultline so the handoff artifact has a stable ID and share link.\n\n```bash\nnode -e '\nconst fs = require(\"node:fs\");\nconst { Vaultline } = require(\"@builtbyecho/vaultline-sdk\");\nconst briefPath = \"AGENT_BRIEF.md\";\nconst content = fs.readFileSync(briefPath, \"utf8\");\nconst vault = new Vaultline({ apiKey: process.env.VAULTLINE_API_KEY });\nvault.files.upload({\n path: `handoffs/${Date.now()}-agent-brief.md`,\n content,\n contentType: \"text/markdown\"\n}).then(r => console.log(\"Vaultline fileId:\", r.fileId));\n'\n```\n\nThis avoids stale local links in PRs, tickets, and incident channels.\n\nFile v0.2.3:_meta.json\n\n{\n \"ownerId\": \"kn788ycwjjfc27w9rytz2e7wxs85jnzh\",\n \"slug\": \"repo-agent-brief\",\n \"version\": \"0.2.3\",\n \"publishedAt\": 1778792493876\n}\n\nFile v0.2.3:skill-card.md\n\n## Description:
\nGenerate concise, safety-aware repository orientation briefs with repo-agent-brief/agent-brief before coding-agent work, reviews, handoffs, PR analysis, unfamiliar repo edits, diff-aware branch handoffs, or when an agent needs stack/commands/context/risk signals before changing files.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[builtbyecho](https://clawhub.ai/user/builtbyecho)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nDevelopers and engineering teams use this skill to orient agents before repository edits, reviews, PR handoffs, or safety-sensitive changes. It helps generate compact repository briefs, branch handoffs, and machine-readable context for downstream automation.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Generated repository briefs may include private repository details, secrets, configuration values, or internal snippets.
\nMitigation: Review and redact generated briefs before sharing; use --no-snippets for sensitive projects.
\nRisk: The optional Vaultline upload workflow uses VAULTLINE_API_KEY to publish a handoff artifact outside the local workspace.
\nMitigation: Provide a minimally scoped VAULTLINE_API_KEY only when upload is intended, and review the brief before upload.
\nRisk: The skill is not a full secret scanner and may miss sensitive material.
\nMitigation: Use a dedicated scanner such as Gitleaks or TruffleHog for full audits, and use --fail-on-high-risk for stricter workflows.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/builtbyecho/repo-agent-brief)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Markdown, JSON, Shell commands, Guidance]
\n**Output Format:** [Markdown or JSON, with inline shell commands for generating and reviewing repository briefs]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Briefs may include repository snippets unless generated with --no-snippets.]
\n\n## Skill Version(s):
\n0.2.3 (source: server release evidence)
\n\n## Ethical Considerations:
\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 v0.2.2: 2 files, 1145 bytes\n\nFiles: SKILL.md (1679b), _meta.json (135b)\n\nFile v0.2.2:SKILL.md\n\n---\nname: repo-agent-brief\ndescription: Generate concise, safety-aware repository orientation briefs with repo-agent-brief/agent-brief before coding-agent work, reviews, handoffs, PR analysis, unfamiliar repo edits, diff-aware branch handoffs, or when an agent needs stack/commands/context/risk signals before changing files.\n---\n\n# Repo Agent Brief Skill\n\nUse `repo-agent-brief` to orient an agent before it edits or reviews a repository. It finds high-signal context files, infers stack/commands, builds a compact repo map, and flags obvious secret/risky-instruction patterns.\n\n## Default workflow\n\nFrom the repository root:\n\n```bash\nnpx repo-agent-brief . > AGENT_BRIEF.md\nsed -n '1,220p' AGENT_BRIEF.md\n```\n\nFor in-progress branches:\n\n```bash\nnpx repo-agent-brief . --diff origin/main > AGENT_HANDOFF.md\nsed -n '1,260p' AGENT_HANDOFF.md\n```\n\nFor machine-readable automation:\n\n```bash\nnpx repo-agent-brief . --format json > agent-brief.json\n```\n\n## When to use\n\n- First pass in an unfamiliar repo.\n- Before delegating to a coding agent.\n- PR/branch handoff where changed files matter.\n- Safety preflight before touching CI, migrations, deploy scripts, auth, or config.\n\n## Safety\n\n- This is not a full secret scanner. Use Gitleaks/TruffleHog for full audits.\n- If high-risk patterns are found, inspect before proceeding.\n- Use `--fail-on-high-risk` in CI or strict agent workflows.\n- Generated briefs may include snippets from repo context files; avoid posting publicly without review.\n\n## Useful commands\n\n```bash\nnpx repo-agent-brief .\nnpx repo-agent-brief . --diff HEAD\nnpx repo-agent-brief . --diff origin/main --fail-on-high-risk\nnpx repo-agent-brief . --no-snippets\n```\n\nFile v0.2.2:_meta.json\n\n{\n \"ownerId\": \"kn788ycwjjfc27w9rytz2e7wxs85jnzh\",\n \"slug\": \"repo-agent-brief\",\n \"version\": \"0.2.2\",\n \"publishedAt\": 1778786245845\n}\n\nArchive v0.2.1: 2 files, 1145 bytes\n\nFiles: SKILL.md (1679b), _meta.json (135b)\n\nFile v0.2.1:SKILL.md\n\n---\nname: repo-agent-brief\ndescription: Generate concise, safety-aware repository orientation briefs with repo-agent-brief/agent-brief before coding-agent work, reviews, handoffs, PR analysis, unfamiliar repo edits, diff-aware branch handoffs, or when an agent needs stack/commands/context/risk signals before changing files.\n---\n\n# Repo Agent Brief Skill\n\nUse `repo-agent-brief` to orient an agent before it edits or reviews a repository. It finds high-signal context files, infers stack/commands, builds a compact repo map, and flags obvious secret/risky-instruction patterns.\n\n## Default workflow\n\nFrom the repository root:\n\n```bash\nnpx repo-agent-brief . > AGENT_BRIEF.md\nsed -n '1,220p' AGENT_BRIEF.md\n```\n\nFor in-progress branches:\n\n```bash\nnpx repo-agent-brief . --diff origin/main > AGENT_HANDOFF.md\nsed -n '1,260p' AGENT_HANDOFF.md\n```\n\nFor machine-readable automation:\n\n```bash\nnpx repo-agent-brief . --format json > agent-brief.json\n```\n\n## When to use\n\n- First pass in an unfamiliar repo.\n- Before delegating to a coding agent.\n- PR/branch handoff where changed files matter.\n- Safety preflight before touching CI, migrations, deploy scripts, auth, or config.\n\n## Safety\n\n- This is not a full secret scanner. Use Gitleaks/TruffleHog for full audits.\n- If high-risk patterns are found, inspect before proceeding.\n- Use `--fail-on-high-risk` in CI or strict agent workflows.\n- Generated briefs may include snippets from repo context files; avoid posting publicly without review.\n\n## Useful commands\n\n```bash\nnpx repo-agent-brief .\nnpx repo-agent-brief . --diff HEAD\nnpx repo-agent-brief . --diff origin/main --fail-on-high-risk\nnpx repo-agent-brief . --no-snippets\n```\n\nFile v0.2.1:_meta.json\n\n{\n \"ownerId\": \"kn788ycwjjfc27w9rytz2e7wxs85jnzh\",\n \"slug\": \"repo-agent-brief\",\n \"version\": \"0.2.1\",\n \"publishedAt\": 1778436173375\n}","readmeExcerpt":"Skill: repo-agent-brief Owner: builtbyecho Summary: Generate concise, safety-aware repository orientation briefs with @builtbyecho/repo-agent-brief/agent-brief before coding-agent work, reviews, handoffs, PR a... Tags: agent-tools:0.2.1, builtbyecho:0.2.1, handoffs:0.2.1, latest:0.4.1 Version history: v0.4.1 | 2026-05-27T23:58:10.353Z | user Prefer canonical scoped npm package @builtbyecho/repo-agent-brief v0.2.3 | 2","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"npx @builtbyecho/repo-agent-brief . > AGENT_BRIEF.md\nsed -n '1,220p' AGENT_BRIEF.md"},{"language":"bash","snippet":"npx @builtbyecho/repo-agent-brief . --diff origin/main > AGENT_HANDOFF.md\nsed -n '1,260p' AGENT_HANDOFF.md"},{"language":"bash","snippet":"npx @builtbyecho/repo-agent-brief . --format json > agent-brief.json"},{"language":"bash","snippet":"npx @builtbyecho/repo-agent-brief . --diff HEAD --bundle\nsed -n '1,220p' .agent-brief/brief.md\nsed -n '1,160p' .agent-brief/verification.md"},{"language":"bash","snippet":"npx @builtbyecho/repo-agent-brief .\nnpx @builtbyecho/repo-agent-brief . --diff HEAD\nnpx @builtbyecho/repo-agent-brief . --diff HEAD --bundle\nnpx @builtbyecho/repo-agent-brief . --diff origin/main --fail-on-high-risk\nnpx @builtbyecho/repo-agent-brief . --no-snippets"},{"language":"bash","snippet":"npx repo-agent-brief . > AGENT_BRIEF.md\nsed -n '1,220p' AGENT_BRIEF.md"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: repo-agent-brief\ndescription: Generate concise, safety-aware repository orientation briefs with @builtbyecho/repo-agent-brief/agent-brief before coding-agent work, reviews, handoffs, PR analysis, unfamiliar repo edits, diff-aware branch handoffs, or when an agent needs stack/commands/context/risk signals before changing files.\n---\n\n# Repo Agent Brief Skill\n\nUse `@builtbyecho/repo-agent-brief` to orient an agent before it edits or reviews a repository. It finds high-signal context files, infers stack/commands, builds a compact repo map, and flags obvious secret/risky-instruction patterns.\n\n## Default workflow\n\nFrom the repository root:\n\n```bash\nnpx @builtbyecho/repo-agent-brief . > AGENT_BRIEF.md\nsed -n '1,220p' AGENT_BRIEF.md\n```\n\nFor in-progress branches:\n\n```bash\nnpx @builtbyecho/repo-agent-brief . --diff origin/main > AGENT_HANDOFF.md\nsed -n '1,260p' AGENT_HANDOFF.md\n```\n\nFor machine-readable automation:\n\n```bash\nnpx @builtbyecho/repo-agent-brief . --format json > agent-brief.json\n```\n\nFor durable handoffs:\n\n```bash\nnpx @builtbyecho/repo-agent-brief . --diff HEAD --bundle\nsed -n '1,220p' .agent-brief/brief.md\nsed -n '1,160p' .agent-brief/verification.md\n```\n\n## When to use\n\n- First pass in an unfamiliar repo.\n- Before delegating to a coding agent.\n- PR/branch handoff where changed files matter.\n- Safety preflight before touching CI, migrations, deploy scripts, auth, or config.\n\n## Safety\n\n- This is not a full secret scanner. Use Gitleaks/TruffleHog for full audits.\n- If high-risk patterns are found, inspect before proceeding.\n- Use `--fail-on-high-risk` in CI or strict agent workflows.\n- Generated briefs may include snippets from repo context files; avoid posting publicly without review.\n\n## Useful commands\n\n```bash\nnpx @builtbyecho/repo-agent-brief .\nnpx @builtbyecho/repo-agent-brief . --diff HEAD\nnpx @builtbyecho/repo-agent-brief . --diff HEAD --bundle\nnpx @builtbyecho/repo-agent-brief . --diff origin/main --fail-on-high-risk\nnpx @builtbyecho/repo-agent-brief . --no-snippets\n```"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn788ycwjjfc27w9rytz2e7wxs85jnzh\",\n \"slug\": \"repo-agent-brief\",\n \"version\": \"0.4.1\",\n \"publishedAt\": 1779926290353\n}"},{"path":"skill-card.md","content":"## Description:\n\nGenerates concise, safety-aware repository orientation briefs before coding-agent work, reviews, handoffs, PR analysis, unfamiliar repository edits, or diff-aware branch handoffs.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[builtbyecho](https://clawhub.ai/user/builtbyecho)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and coding agents use this skill to gather repository orientation before edits, reviews, handoffs, pull request analysis, or safety-sensitive changes. It helps identify high-signal context files, stack and command hints, repository structure, and obvious risky-instruction or secret-pattern signals.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill directs users to run an unpinned third-party npm package inside repositories that may contain sensitive code or configuration.\n\nMitigation: Use a pinned, reviewed version of @builtbyecho/repo-agent-brief and run it with minimal repository credentials.\n\nRisk: Generated briefs may include snippets from repository context files.\n\nMitigation: Review generated briefs before sharing them and use --no-snippets when public or broad distribution is expected.\n\n## Reference(s):\n\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown with inline shell commands; JSON is available when the underlying package is run with --format json]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May write repository brief files such as AGENT_BRIEF.md, AGENT_HANDOFF.md, agent-brief.json, or .agent-brief bundle files depending on the selected command.]\n\n## Skill Version(s):\n\n0.4.1 (source: server release metadata)\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":"Generate concise, safety-aware repository orientation briefs with @builtbyecho/repo-agent-brief/agent-brief before coding-agent work, reviews, handoffs, PR a... Skill: repo-agent-brief Owner: builtbyecho Summary: Generate concise, safety-aware repository orientation briefs with @builtbyecho/repo-agent-brief/agent-brief before coding-agent work, reviews, handoffs, PR a... Tags: agent-tools:0.2.1, builtbyecho:0.2.1, handoffs:0.2.1, latest:0.4.1 Version history: v0.4.1 | 2026-05-27T23:58:10.353Z | user Prefer canonical scoped npm package @builtbyecho/repo-agent-brief v0.2.3 | 2","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":878,"uniquenessScore":51,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T17:04:28.781Z","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-11T17:04:28.781Z","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-11T20:57:56.352Z","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"}]}}}