Skip to content
Skills Library
Programming · Research

project-docs

/project-docs

Use when looking for project-specific documentation. Knows which docs exist in agents/reference/docs/ and agents/settings/contexts/ and maps work areas to relevant docs.

Licence
MIT
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use when looking for project-specific documentation. Knows which docs exist in agents/reference/docs/ and agents/settings/contexts/ and maps work areas to relevant docs.

Original author description

Use when looking for project-specific documentation. Knows which docs exist in agents/reference/docs/ and agents/settings/contexts/ and maps work areas to relevant docs.

How it works

  1. When to use
  2. Description
  3. When to Activate
  4. Procedure: Find project documentation
  5. Documentation Structure
  6. Domain Contexts
  7. How to Find Relevant Docs
  8. Rules
  9. Cross-References
  10. Output format
Original SKILL.md headings · 135 lines, 839 words
SKILL.md preview
---
model_tier: medium
name: project-docs
description: "Use when looking for project-specific documentation. Knows which docs exist in agents/reference/docs/ and agents/settings/contexts/ and maps work areas to relevant docs."
domain: process
workspaces:
  - agent-config-maintainer
packs:
  - meta
---

# project-docs

## When to use

Use this skill when:
- Starting work on an unfamiliar area of the codebase
- Need to find relevant documentation for a specific module or feature
- Want to understand project-specific patterns before making changes

Do NOT use when:
- Looking for coding guidelines (use `guidelines` skill)
- Looking for infrastructure docs (use `aws-infrastructure` or `docker` skill)

## Description

This skill maps work areas to their relevant project documentation. It ensures agents
consult the right docs before making changes — preventing mistakes that come from not
understanding project-specific patterns, legacy conventions, or architectural decisions.

## When to Activate

- Before working on **any** area that has project-specific documentation
- When an agent is unsure about project conventions for a specific domain
- When creating or modifying code in areas covered by these docs

## Procedure: Find project documentation

1. Identify the work area from the user's request.
2. Look up the relevant docs in the mapping table below.
3. Read the **context** first (quick orientation), then the **detail docs** if needed.
4. Follow the conventions described in the docs.

## Documentation Structure

```
agents/
├── contexts/          → Quick orientation (read first)
│   ├── *.md           → Technical contexts (multi-tenancy, API versioning, etc.)
│   └── domain/        → Domain/industry knowledge (business logic, terminology)
│       └── job-*.md   → Domain context files (e.g., job-time-tracking.md)
├── docs/              → Deep dives (read when working on the area)
│   └── *.md           → Detailed conventions per topic
├── features/          → Feature plans
├── roadmaps/          → Step-by-step work plans
├── sessions/          → Session tracking
└── overrides/         → Project-specific overrides of .augment/ resources
```

## Domain Contexts

If `agents/settings/contexts/domain/` exists, it contains **business domain knowledge** — industry terms,
regulations, workflows, and edge cases that the agent needs to understand the problem space.

**When to read domain contexts:**
- Before working on any feature that touches business logic
- When you encounter domain-specific terms you don't fully understand
- When writing validations, business rules, or data models for a specific domain

**How to find the right file:**
- List `agents/settings/contexts/domain/` and read files whose name matches the work area
- Files prefixed with `job-` describe industry/profession knowledge
- When in doubt, read all domain context files — they are short orientation docs

## How to Find Relevant Docs

1. **List `agents/settings/contexts/`** — read any context file whose name matches the work area.
2. **List `agents/settings/contexts/domain/`** — read domain knowledge files relevant to the business logic.
3. **List `agents/reference/docs/`** — read detail docs for the specific topic you're working on.
4. **Check module docs** — if working in a module, resolve `{module_root}` from
   `modules.root_paths` and `{agent_folder}` from `modules.agent_folder` (see
   `scripts/_lib/agent_settings.ts::enumerate_modules()`), then check:
   - `{module_root}/{Module}/{agent_folder}/` — module-specific docs
   - `{module_root}/{Module}/{agent_folder}/settings/contexts/` — module-specific contexts (if exists)
   - `{module_root}/{Module}/{agent_folder}/settings/contexts/domain/` — module-specific domain knowledge (if exists)

### Reading order

| Step | What | Why |
|---|---|---|
| 1 | `agents/settings/contexts/*.md` | Quick orientation — big picture in ~100 lines |
| 2 | `agents/settings/contexts/domain/job-*.md` | Domain knowledge — business terms, rules, edge cases |
| 3 | Module `agents/settings/contexts/` | Module-specific contexts (if working in a module) |
| 4 | `agents/reference/docs/*.md` | Deep dive — code examples, conventions, patterns |

### Matching work areas to docs

Match by **filename** — doc filenames describe their topic. Examples:
- Working on API endpoints → look for `controller`, `api-*`, `middleware`, `authentication` docs
- Working on database → look for `database-*`, `multi-tenancy`, `customer-*` docs
- Working on time tracking → look for `job-time-tracking` in domain contexts
- Working on tests → look for `testing`, `seeders` docs

Do NOT hardcode a mapping — always **list the directory** and pick by relevance.

## Rules

- **Always read the context first** — it gives you the big picture in ~100 lines.
- **Read detail docs when you need to write code** — they have code examples and conventions.
- **Don't skip docs because you "know" the pattern** — project-specific conventions often differ
  from standard framework patterns.
- **Update docs when you change conventions** — if your change introduces a new pattern or
  deprecates an old one, update the relevant doc in `agents/reference/docs/`.

## Cross-References

| Skill | Relationship |
|---|---|
| `agent-docs-writing` | When to read/create/update agent docs in general |
| `context-create` | How to create new context documents |
| `module-management` | Module-specific docs in module `agents/` directories |


## Output format

1. Relevant doc paths and their key content summarized
2. Recommendation for which docs to read for the current task

## Gotcha

- Project docs are NOT the same as agent docs — project docs describe the codebase, agent docs describe agent behavior.
- Don't assume a doc exists because the area is important — always check the filesystem first.
- Stale docs are worse than missing docs — always verify doc content against actual code.

## Do NOT

- Do NOT create documentation that duplicates existing docs.
- Do NOT write docs for trivial or self-explanatory code.

## Auto-trigger keywords

- project documentation
- doc mapping
- work area docs

Versions

RepositoryScoreLicence
This page · event4u-app/agent-config100MIT
coco-research/coco100MIT
nasrulhazim/claude100MIT
GGaryyy/POBG100MIT
DPatta/project-docs-kit100MIT
DPatta/project-docs-kit100MIT
jezweb/claude-skills100MIT
waynesutton/builder-skills100Apache-2.0
xstongxue/best-skills100Apache-2.0

Database snapshot: 13.11.2026 · package version 10e9a0657b43 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100looking-up-docs
    Look up library documentation using Context7. Use when needing API reference, library docs, framework documentation, or technical documentation lookup. Provides up-to-date, version-specific docs and code examples.
  • 100docs-init
    Bootstrap agent-ready project documentation in docs/ plus an AGENTS.md entry point, tailored to the project type (backend, frontend, fullstack, mobile). Focuses on flows and conventions an AI agent needs before changing code. Marks anything that cannot be derived from code and…
  • 90update-project
    Use when updating docs, syncing AGENTS.md, CLAUDE.md, or README.md, fixing stale documentation, or refreshing project rules and skills. Keeps docs aligned with code changes.
  • 100md-docs
    Manages project documentation: CLAUDE.md, AGENTS.md, README.md, CONTRIBUTING.md, DOCS.md. Use when asked to update, create, or init these context files. Not for general markdown editing.
  • 80vc:docs
    Use when you need to analyze a codebase and initialize, update, or summarize project documentation.
  • 100pr-with-docs
    Creates production-ready pull requests with automatically updated AGENTS.md and project docs. Use when the user asks to create a PR, make a PR, is ready to merge, has finished a feature and wants a PR, or says they're done for the day with changes to commit.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.