Analyze Project Skill
Use this skill when the user wants to understand a target ontology repository before contributing or cloning. You produce a short, structured report so the user (or a follow-up clone/issue/PR workflow) knows the layout, build system, contribution rules, and issue/PR expectations.
When to Use
- User says they want to contribute to or work on an external ontology and provides a repo URL (or repo owner/name).
- User asks "how do I contribute to this project", "what's the structure of this repo", "analyze this ontology repo", or similar.
- Before cloning or picking issues: analyzing first avoids wrong paths and missed conventions.
Use web fetch or search (and optionally terminal to list files if the repo is already cloned under projects/). Do not clone the repo only to analyze it—use the GitHub repo page, README, CONTRIBUTING, and .github structure from the web or from an existing clone.
Workflow
- Identify the repo: From the user's message, get the repo URL or
owner/repo (e.g. from a GitHub link).
- Gather structure: Fetch or read:
- README: scope, build instructions, where ontology source lives (often
ontology/ or the project's edit directory).
- Top-level layout: key dirs (e.g.
ontology/, imports/, subsets/, mappings/, docs/, .github/).
- Build system: ODK Makefile, Docker, CI (e.g.
.github/workflows/*.yml), and how to run tests/QC (e.g. make test, make -C ontology test).
- CONTRIBUTING (or "Contributing" in README): issue-first?, required fields for new term requests, link to editor guides or OBO Academy.
- Issue/PR conventions: presence of
.github/ISSUE_TEMPLATE/, .github/PULL_REQUEST_TEMPLATE.md, CODEOWNERS; common labels and branch naming (e.g. issue-N, feature/term-name).
- Synthesize: Produce a short structure report (see Output format below).
Output Format
Return a concise report with:
- Layout: Top-level directories and where the ontology edit file lives (e.g.
ontology/). Note the edit file path so it can be opened with the ontology-editor tools when working on a clone.
- Build and CI: What QC the target repository runs on pull requests (e.g.
.github/workflows/*.yml, ODK/ROBOT checks). QC is executed by the target repo's CI on the PR — it is not run locally in this workspace.
- Contributing: Issue-first? Where to find CONTRIBUTING; main contribution types (e.g. new term request, synonym, obsoletion).
- Issue/PR expectations: Any issue templates (NTR, bug, etc.); PR checklist or description expectations (e.g. "Closes #N", change table); review expectations if visible.
Use hypothetical wording (e.g. "a typical OBO ontology", "a repo that uses NTR templates")—do not name specific real-world ontologies as examples.
Notes
- If the repo is already cloned under
projects/<slug>/, you may list files and read CONTRIBUTING/README from disk instead of (or in addition to) fetching from the web.
- This skill does not clone; use the clone-project skill to clone into
projects/<slug>/ after (or in parallel with) analysis.
1---2name: analyze-project3description: Understand a target ontology repo's structure, contribution workflow, and build setup. Use whenever the user wants to analyze an ontology repository, learn how to contribute to a project, understand repo layout, or inspect CONTRIBUTING/issue/PR conventions—e.g. "analyze this ontology repo", "how do I contribute to this project", "what's the structure of this repo", or when they provide a repo URL. Prefer this skill over ad-hoc inspection when contributing to external ontologies.4---56# Analyze Project Skill78Use this skill when the user wants to **understand a target ontology repository** before contributing or cloning. You produce a short, structured report so the user (or a follow-up clone/issue/PR workflow) knows the layout, build system, contribution rules, and issue/PR expectations.910## When to Use1112- User says they want to **contribute to** or **work on** an external ontology and provides a repo URL (or repo owner/name).13- User asks **"how do I contribute to this project"**, **"what's the structure of this repo"**, **"analyze this ontology repo"**, or similar.14- Before cloning or picking issues: analyzing first avoids wrong paths and missed conventions.1516Use **web fetch or search** (and optionally terminal to list files if the repo is already cloned under `projects/`). Do **not** clone the repo only to analyze it—use the GitHub repo page, README, CONTRIBUTING, and `.github` structure from the web or from an existing clone.1718## Workflow19201. **Identify the repo**: From the user's message, get the repo URL or `owner/repo` (e.g. from a GitHub link).212. **Gather structure**: Fetch or read:22 - **README**: scope, build instructions, where ontology source lives (often `ontology/` or the project's edit directory).23 - **Top-level layout**: key dirs (e.g. `ontology/`, `imports/`, `subsets/`, `mappings/`, `docs/`, `.github/`).24 - **Build system**: ODK Makefile, Docker, CI (e.g. `.github/workflows/*.yml`), and how to run tests/QC (e.g. `make test`, `make -C ontology test`).25 - **CONTRIBUTING** (or "Contributing" in README): issue-first?, required fields for new term requests, link to editor guides or OBO Academy.26 - **Issue/PR conventions**: presence of `.github/ISSUE_TEMPLATE/`, `.github/PULL_REQUEST_TEMPLATE.md`, CODEOWNERS; common labels and branch naming (e.g. `issue-N`, `feature/term-name`).273. **Synthesize**: Produce a short **structure report** (see Output format below).2829## Output Format3031Return a concise report with:3233- **Layout**: Top-level directories and where the ontology edit file lives (e.g. `ontology/`). Note the edit file path so it can be opened with the ontology-editor tools when working on a clone.34- **Build and CI**: What QC the target repository runs on pull requests (e.g. `.github/workflows/*.yml`, ODK/ROBOT checks). QC is executed by the target repo's CI on the PR — it is not run locally in this workspace.35- **Contributing**: Issue-first? Where to find CONTRIBUTING; main contribution types (e.g. new term request, synonym, obsoletion).36- **Issue/PR expectations**: Any issue templates (NTR, bug, etc.); PR checklist or description expectations (e.g. "Closes #N", change table); review expectations if visible.3738Use hypothetical wording (e.g. "a typical OBO ontology", "a repo that uses NTR templates")—do not name specific real-world ontologies as examples.3940## Notes4142- If the repo is already cloned under `projects/<slug>/`, you may list files and read CONTRIBUTING/README from disk instead of (or in addition to) fetching from the web.43- This skill does not clone; use the **clone-project** skill to clone into `projects/<slug>/` after (or in parallel with) analysis.