# Same-Repository Docs



<a id="section-goal"></a>

When the Context knowledge workspace sits inside a project repository, that repository usually already has documentation and Agent Skills. They should stay where they are and keep being edited there. `repo-content.yaml` registers them as **same-repository content**: Context links to the originals instead of copying their bodies into knowledge or source snapshots.

```mermaid
flowchart LR
  orig["docs/ and .agents/skills/<br/>the only originals"] --> links["repo-content/<br/>relative symlinks"]
  orig --> ev["Evidence<br/>repo-content:docs@commit"]
  links --> pages["Pages link with<br/>context:repo/..."]
  pages --> pkg["Optional entrance page<br/>in the package or site"]
```

Use the `context-repo-content` Skill to choose and edit these entries; it does not start knowledge production.


<a id="section-register"></a>

## Register

At the knowledge workspace root:

```yaml
protocol: context.repo-content/v1
entries:
  docs:
    kind: docs
    path: docs
  tools:
    kind: skills
    path: .agents/skills
```

Paths are relative to the Git root, not the knowledge workspace. Kinds are `docs`, `document`, `skills` and `skill`. Optional `group` adds one module level, `mount` overrides the default mount name, and `exclude` globs skip files inside an entry (they are not access control). Overlapping entries, targets outside the repository, nested repositories and cycles are rejected.

`context source ensure repo-content --format json` maintains the relative symlinks under `repo-content/`; `context status` reports problems without repairing them. Ordinary files are never overwritten, and no Git configuration or index changes.


<a id="section-cite"></a>

## Link and cite

A page links to an original with `[Guide](context:repo/docs/guide.md)`; build turns it into an upstream link when one is available, otherwise a plain location. Evidence records `repo-content:docs@<full-commit>` with the real path, line range and digest; uncommitted text is recorded as `<commit>+worktree`.


<a id="section-page"></a>

## Optional entrance page

```ts
kbPackage({ name: "project-kb", template: { path: "src/package-templates/kb" }, repoContentPage: true });
```

This projects each group's README and the Skill names and descriptions into `wikis/repo-content.md`; it does not copy all docs or Skill scripts. `{ site: true }` adds the entrance to a configured website. Review README sensitivity before exposing it.


<a id="section-fix"></a>

## When something is wrong

- An invalid `repo-content.yaml` is reported by `status`, and `context build` stops before replacing existing outputs. Correct the file rather than rerunning `ensure`.
- `ensure` is suggested only for missing or misdirected symlinks.
- Other repositories and externally installed Skills are not same-repository content; declare them as [External Entrances](</context/llms/pages/3c35b84bd6846bd03f010004a29bf565.txt>).

Registering an entrance does not authorize installing, running or publishing anything.

---

## Sources

- [context/packages/context/docs/guides/repo-content.md L3–L5 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/repo-content.md#L3-L5>)
- [context/plugins/context/skills/context-repo-content/SKILL.md L1–L4 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/plugins/context/skills/context-repo-content/SKILL.md#L1-L4>)
- [context/packages/context/docs/guides/repo-content.md L7–L31 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/repo-content.md#L7-L31>)
- [context/packages/context/docs/guides/repo-content.md L43–L48 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/repo-content.md#L43-L48>)
- [context/packages/context/docs/guides/repo-content.md L50–L67 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/repo-content.md#L50-L67>)
- [context/packages/context/docs/guides/repo-content.md L33–L41 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/repo-content.md#L33-L41>)
- [context/packages/context/docs/guides/repo-content.md L69–L71 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/repo-content.md#L69-L71>)