Gitea Repo Ingest
Ingest public Git repositories or repositories on the configured Gitea server into the Research KB. Use for Git/Gitea source scans that need OpenClaw code understanding, incremental commit comparison, code repository overview pages, concept pages, resource pages, related wiki page updates, source tr Skill: Gitea Repo Ingest Owner: myd2002 Summary: Ingest public Git repositories or repositories on the configured Gitea server into the Research KB. Use for Git/Gitea source scans that need OpenClaw code understanding, incremental commit comparison, code repository overview pages, concept pages, resource pages, related wiki page updates, source tr Tags: latest:1.0.6 Version history: v1.0.6 | 2026-07-09T14:37:58.657Z
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.0.6
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.6release · observed Jul 9, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: medium.
clawhub skill install s175zrvz5m28epr76c6rt4dtex8474t6:gitea-repo-ingest- Python environment detected. Create a strict virtual environment (`python -m venv .venv`) before installing dependencies to prevent system-level package conflicts.
- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- 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: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-myd2002-gitea-repo-ingest/snapshot"
Run-check
$0.02 USD1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.
Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.
Documentation
CLAWHUB
76,824 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: gitea_repo_ingest
description: Ingest public Git repositories or repositories on the configured Gitea server into the Research KB. Use for Git/Gitea source scans that need OpenClaw code understanding, incremental commit comparison, code repository overview pages, concept pages, resource pages, related wiki page updates, source traceability manifests, and Gitea-backed catalog/index updates.
---
# gitea_repo_ingest
## 核心职责
把一个可读取的代码仓库沉淀为团队知识库里的代码知识图谱。OpenClaw 负责深度代码理解和页面写作;本 skill 自带 Python 工具负责确定性动作:读取仓库、判断增量、采样证据、读取现有 catalog、写回 Markdown 页面、登记代码仓库来源、维护 `catalog.json`、维护 `index.md`、输出后端可读 JSON。
支持范围:
- 用户输入的公开 Git 仓库。
- 用户输入的、部署在已配置 `GITEA_URL` 上且 bot token 可访问的 Gitea 仓库。
- 同一 Gitea 的 HTTPS URL、`ssh://git@host/owner/repo.git`、`git@host:owner/repo.git` 会尽量转换成 bot token 可访问的 HTTPS URL。
- Git 交互式凭据提示必须关闭;认证失败、仓库不存在、无权限或网络不可达时应快速失败并脱敏错误。
- 其他外部私有仓库可以失败,不需要绕过权限。
不要把完整源码仓库复制到知识库。知识库保存的是可复用理解:仓库用途、业务/科研目标、功能模块、工作流、领域概念、资源依赖、接口数据、运行部署、设计取舍、风险限制、版本变化和页面关系。
写 `pages.json` 前先私下做一次知识图谱规划:代码库主页面是实体入口;`concepts/` 用来沉淀跨模块、跨资料可复用的抽象知识;`resources/` 用来登记具体可复用对象;`overview/` 用来维护团队级导航、系统地图、项目/主题综合和资料入口。不要为了满足格式机械建概念页、资源页或 overview 页;但当仓库理解显示某个已有主题、项目、架构概念、外部资源或团队导航需要更新时,应主动更新并建立跳转关系。
## 必须使用的脚本流程
不要直接手写 Gitea API。按准备、校验、写回流程执行:
1. 准备上下文:
```bash
python3 scripts/run_task.py prepare --input <payload.json> --context-output <context.json>
```
如果输出 JSON 的 `mode` 是 `skip`,说明最新 commit 与上一轮 snapshot 一致。此时脚本已经可以写出 skip 结果;直接让最终回复指向 payload 中的 `resultFile`。
2. 基于 `<context.json>` 进行代码理解,先私下规划代码库页、概念页、资源页、overview/项目页和已有相关页之间的关系,再生成 `<pages.json>`。`pages.json` 必须是纯 JSON 对象,不允许包含 Markdown 解释、注释、尾随逗号或未转义反斜杠;正文里如果出现代码片段、Windows 路径、正则表达式、JSON 字符串或反引号,必须使用 JSON writer/serializer 写文件,或完整转义。`pages.json` 必须包含 `pages[]`,每个页面包含 `path`、`title`、`type`、`content`、`keywords`、`relatedConcepts`、`relatedResources`、`relatedCodePages`、`relatedPages`。
3. 校验 `<pages.json>`,不写入知识库:
```bash
python3 scripts/run_task.py validate-pages --input <payload.json> --context <context.json> --pages <pages.json>
```
如果校验失败,必须修正 `<pages.json>` 并重新运行 `validate-pages`。只有校验成功后才能执行 `apply`。不要把 `validate-pages` 的 `success=true` 当作最终结果;`validate-pages` 不写 `resultFile`,必须继续运行 `apply`。
4. 写回知识库:
```bash
python3 scripts/run_task.py apply --input <payload.json> --context <context.json> --pages <pages.json>
```
`apply` 会写入 OpenClaw 生成的正常 Wiki 页面,重建 frontmatter,写入 `source_files/gitea_repo/<sourceId>-<repo-slug>.md` 来源登记文件,更新 `catalog.json` 和 `index.md`,写回一个稳定 `itemKey` 的仓库级 `sourceItems[]` 资料项,并把后端需要的 JSON envelope 写到 payload 的 `resultFile`。
5. 最终只回复 JSON,例如:
```json
{"success": true, "resultFile": "<result.json>"}
```
如果脚本报错,修正输入或页面 JSON 后重试。不要在未完成代码理解时写低质量占位总览。
## 输入约定
任务 payload 通常包含:
- `taskId`: 后端任务 ID。
- `payloadFile`: 后端写出的 payload 路径。
- `resultFile`: 需要写入的结果 JSON 路径。
- `skill`: `gitea_repo_ingest`。
- `source.id`、`source.name`、`source.type`: 资料源信息。
- `source.config.repoUrl`: 用户填写且后端已校验可读的仓库地址。
- `source.config.defaultBranch`: 后端尝试识别的默认分支,可为_meta.json
{
"ownerId": "kn7cp7eb6ymqv898hke0ersmc1847fed",
"slug": "gitea-repo-ingest",
"version": "1.0.6",
"publishedAt": 1783607878657
}skill-card.md
## Description: Ingests public Git repositories or repositories on a configured Gitea server into a Research KB with code understanding, incremental comparison, source traceability, and catalog/index maintenance. This skill is ready for commercial/non-commercial use. ## Publisher: [myd2002](https://clawhub.ai/user/myd2002) ### License/Terms of Use: MIT-0 ## Use Case: Developers and knowledge-base maintainers use this skill to convert Git or configured Gitea repositories into Research KB wiki pages, source manifests, repository snapshots, and catalog/index updates. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill handles Gitea credentials while reading and writing repository content. Mitigation: Use a tightly scoped Gitea bot token, keep repository URLs and platform configuration trusted, and avoid embedding tokens in git URLs. Risk: Repository files may be untrusted and could expose sensitive paths or misleading content during sampling. Mitigation: Run only against trusted repositories, block symlink traversal during sampling, and clean or sanitize worktrees after use. ## Reference(s): - [Gitea Repo Ingest on ClawHub](https://clawhub.ai/myd2002/skills/gitea-repo-ingest) ## Skill Output: **Output Type(s):** [text, markdown, code, shell commands, configuration, JSON] **Output Format:** [Markdown wiki pages plus JSON context, validation, and result envelopes] **Output Parameters:** [1D] **Other Properties Related to Output:** [Writes Research KB pages, source traceability manifests, catalog/index updates, repository snapshots, and repository-level sourceItems records.] ## Skill Version(s): 1.0.6 (source: ClawHub release evidence) ## Ethical Considerations: Users 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.
env-example.txt
GITEA_URL=http://127.0.0.1:3000 GITEA_BOT_TOKEN= GITEA_BOT_USERNAME=research-kb-bot GITEA_ORG= TEAM_KB_REPO=team-kb OPENCLAW_SHARED_DIR=/srv/research-kb/shared
requirements.txt
# gitea_repo_ingest uses only the Python 3 standard library and the git CLI.
AionUi
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!
activepieces
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
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/myd2002/skills/gitea-repo-ingest",
"sourceUrl": "https://clawhub.ai/myd2002/skills/gitea-repo-ingest",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T13:59:58.368Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-myd2002-gitea-repo-ingest/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-myd2002-gitea-repo-ingest/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T13:59:58.368Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/myd2002/gitea-repo-ingest",
"sourceUrl": "https://clawhub.ai/myd2002/gitea-repo-ingest",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T13:59:58.368Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.6",
"href": "https://clawhub.ai/myd2002/gitea-repo-ingest",
"sourceUrl": "https://clawhub.ai/myd2002/gitea-repo-ingest",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-09T14:37:58.657Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-myd2002-gitea-repo-ingest/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-myd2002-gitea-repo-ingest/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.6",
"description": "gitea-repo-ingest 1.0.6 - Clarified usage of the validate-pages script: do not treat successful validation as the final result; always continue to the apply stage, as only apply updates the final result file. - Documented that apply writes a stable itemKey in the sourceItems array for repository sources, improving catalog consistency. - No code or implementation changes; documentation updated for workflow accuracy and clarity.",
"href": "https://clawhub.ai/myd2002/gitea-repo-ingest",
"sourceUrl": "https://clawhub.ai/myd2002/gitea-repo-ingest",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-09T14:37:58.657Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
