Skip to content
Skills Library
AI & agents · Review & audit

cross-reference-mapper

/cross-reference-mapper

Discover and maintain `## Cross-references` between ORS skills. Given a new or edited skill, suggest related skills (same category, shared tags, complementary workflows). Verify all xref slugs resolve to existing SKILL.md files. Use when adding a new skill, when sibling skills move, or when an audit reveals dangling xrefs.

Licence
MIT
Last repository change
24.06.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
1
URLs in SKILL.md
0
Deprecation

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

Licence

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

What to check before installing
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

What it does and when to use it

Discover and maintain `## Cross-references` between ORS skills. Given a new or edited skill, suggest related skills (same category, shared tags, complementary workflows). Verify all xref slugs resolve to existing SKILL.md files. Use when adding a new skill, when sibling skills move, or when an audit reveals dangling xrefs.

Original author description

Discover and maintain `## Cross-references` between ORS skills. Given a new or edited skill, suggest related skills (same category, shared tags, complementary workflows). Verify all xref slugs resolve to existing SKILL.md files. Use when adding a new skill, when sibling skills move, or when an audit reveals dangling xrefs.

How it works

  1. When to use
  2. When NOT to use
  3. Hard rules
  4. How xrefs work
  5. Generating xrefs for a new skill
  6. Verifying existing xrefs
  7. Cross-reference style guide
  8. Validation
  9. Cross-references
  10. Changelog
Original SKILL.md headings · 144 lines, 758 words
SKILL.md preview
---
name: cross-reference-mapper
description: "Discover and maintain `## Cross-references` between ORS skills. Given a new or edited skill, suggest related skills (same category, shared tags, complementary workflows). Verify all xref slugs resolve to existing SKILL.md files. Use when adding a new skill, when sibling skills move, or when an audit reveals dangling xrefs."
license: MIT
---
<!-- metadata:
  oversight: low
  version: 1.0.0
  author: ORS maintainers
  tags: [meta, cross-references, navigation, catalog]
  difficulty: intermediate
-->

# Cross-Reference Mapper

The ORS catalog is a graph: 100+ skills in 18+ categories that should be
navigable by clicking between them. This skill produces and maintains the
`## Cross-references` section in each skill's body.

## When to use

- Adding a new skill — generate its `## Cross-references` from the catalog.
- Adding a new category — propagate the change to all sibling skills.
- Renaming a skill — find every xref that references it and rewrite.
- Auditing the catalog — find dangling xrefs (slugs that don't resolve).
- Answering "what skills should I use for X?" — produce a curated trail.

## When NOT to use

- Reading or using an existing skill (load that skill directly).
- Auditing for content quality (use `meta/integrity-audit`).

## Hard rules

1. **No fabricated citations.** Every cited work must resolve to a verifiable
   record (DOI, PMID, arXiv ID, ISBN, URL with retrieval date, or stable
   identifier). If a source cannot be resolved, the skill must say so
   explicitly rather than presenting the claim as established.
2. **No claim without provenance.** Every quantitative or factual claim
   must point to a file, line, table, figure, dataset, or external source
   the agent can show. "Trust me" is not provenance.
3. **No silent failure.** Every script invocation, API call, or tool use
   must declare its exit status and what to do on non-zero. A skill that
   silently swallows errors is a violation.

## How xrefs work

Every `## Cross-references` section is a flat bullet list:

```text
Example xref section (these slugs are illustrative, not validated):

  ## Cross-references

  - systematic-review — full PRISMA 2020 systematic review with screening.
  - citation-management — Zotero / BibTeX / DOI workflows.
  - meta/integrity-audit — 7-mode AI failure-mode checklist applied before publish.
```

A slug resolves if either `skills/<category>/<slug>/SKILL.md` exists
**or** `meta/<slug>/SKILL.md` exists. The `meta/` prefix in the bullet
disambiguates.

## Generating xrefs for a new skill

When a new SKILL.md is added, generate its `## Cross-references` from
three sources, in priority order:

### 1. Same-category siblings

List all other skills in `skills/<category>/` with a one-line description
taken from each skill's frontmatter `description` (first sentence).

If the category has only one skill (this one), skip — go to source 2.

### 2. Tag-overlapping skills

If the new skill has tags `["rna-seq", "alignment"]`, find all other
skills whose tags overlap by ≥1. Score each candidate by:
- 3 points per shared tag
- +1 if same category
- -2 if very different oversight level (one is generative, one is mechanical)
- +2 if both reference each other in their `## Related Skills` or similar

Take the top 5 by score.

### 3. Workflow-complementary skills

These are skills that handle a *later* stage of the same pipeline:
- For a wet-lab protocol skill, list the analysis skills that consume its
  output.
- For an analysis skill, list the visualization / writing skills that
  consume its output.
- For a writing skill, list the literature-research skills that feed it.

## Verifying existing xrefs

Run from the repo root:

```bash
python scripts/validate-skills.py skills/   # xrefs are validated by this
```

A failing xref means the slug was renamed or the skill was moved. To fix:

1. Identify the renamed/moved skill in the diff.
2. Find every xref that references the old slug.
3. Rewrite to use the new slug.

A common cause: a skill is moved from `skills/<cat>/old-name/` to
`skills/<cat>/new-name/` (or to `meta/`). All xrefs must be updated.

## Cross-reference style guide

**Good:**
```
- bwa-alignment — BWA-MEM short-read aligner; standard for Illumina DNA-seq.
- samtools-bam-processing — SAM/BAM manipulation; downstream of all aligners.
- star-alignment — spliced aligner for RNA-seq; alternative to BWA for RNA.
```

**Bad:**
```
- bwa-alignment
- samtools-bam-processing
- star-alignment
```

The one-line description tells the reader whether to click through. A bare
slug forces them to load every skill to find the relevant one.

## Validation

A skill's xrefs are valid when:
- Every slug in the section resolves to an existing `SKILL.md`.
- Each line has the form `- <slug> — <description>` (em-dash separator).
- The skill does NOT xref itself.

## Cross-references

- meta/roadmap-author — use this skill as the final step of authoring.
- meta/integrity-audit — finds dangling xrefs as part of mode 6 (version drift).
- meta/release-management — version bumps should trigger an xref re-verification.

## Changelog

- **1.0.0** (2026-06-17) — Initial release. Algorithm distilled from the
  cross-reference patterns used by the bulk-migration of 116 existing skills.

Versions

The database has no other skills named cross-reference-mapper.

Database snapshot: 13.11.2026 · package version d05752a2a2fd (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

  • 100roadmap-author
    Author a new ORS skill from scratch using the v0.4.0 schema. Produces a valid SKILL.md (frontmatter + metadata + sections) following spec/skill-format.md, guided by spec/author-guide.md, validated by scripts/validate-skills.py. Use when a user says 'add a new skill', 'create a…
  • 100agent-handoff
    Pass work between ORS skills with a Material Passport — a structured JSON envelope that captures inputs, outputs, decisions, and provenance so a downstream skill can resume without re-deriving context. Use when one skill produces output that another skill must consume,…
  • 90writing-skills
    Use when creating new skills, editing existing skills, or verifying skills work before deployment
  • 90review-skills
    Reviews Agent Skills. Use when auditing skills in a codebase, checking a new or edited SKILL.md, or verifying that a skill follows the Agent Skills spec.
  • 95sp-writing-skills
    Use when creating new skills, editing existing skills, or verifying skills work before deployment
  • 100add-resource-skill
    Authors a new skills.sh-formatted skill for the pixee CLI under skills/pixee-<noun>/SKILL.md. Trigger on requests like "add a resource skill", "write a skill for pixee X", "author a pixee skill", or "publish a skill for the new Y subcommand". Captures pixee-specific conventions…

Feedback and reports

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