Skip to content
Back to skills

People Stubs

ASecurity

Batch-create Teams/People/@Name.md stubs from unresolved [[@*]] wikilinks across the vault. Each stub is minimal frontmatter; the user fills team/role/details later.

  • 165 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agents

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add benoror/obsidianos_work --skill people-stubs --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of People Stubs?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for People Stubs
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/benoror-people-stubs/badge)](https://www.skillsdirectory.com/skills/benoror-people-stubs)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: people-stubs
description: "Batch-create Teams/People/@Name.md stubs from unresolved [[@*]] wikilinks across the vault. Each stub is minimal frontmatter; the user fills team/role/details later."
license: MIT
---

# People Stubs

## Usage

- `/people-stubs` — Scan unresolved `[[@*]]` links, present a creation list, prompt to confirm each.
- `/people-stubs --auto` — Create stubs for every unresolved `[[@*]]` link without per-name confirmation. Useful after a big batch of new interviews.

## Why this skill exists

When meeting notes are wrapped via `/fill-participants`, names get linked as `[[@Jane Doe]]`, `[[@John Smith]]`, etc. If the corresponding `Teams/People/@Name.md` file doesn't exist yet, Obsidian shows a dead-link indicator and the name doesn't appear in `People.base`. This skill creates the missing stubs in one pass.

Stubs are intentionally minimal — they're placeholders. The user (or a future `/onboard-person` skill) fills in the real metadata (Team, Location, FullName, Start Date, etc.).

## Workflow

### Step 1: Discover unresolved [[@*]] links

Run `obsidian unresolved format=json` and filter to entries where the link target starts with `@`. Aggregate by target — one stub per unique target, with a list of files where it's referenced.

### Step 2: Present the creation list

Display a numbered table sorted by reference count descending:

```
| # | Stub to create | Referenced in (count) | Sample file |
|---|----------------|----------------------|-------------|
| 1 | Teams/People/@Jane Doe.md | 6 | Meetings/Interviews/Interview Alex Kim... |
| 2 | Teams/People/@John Smith.md | 3 | Meetings/Engineering/Weekly Team Leads... |
| 3 | Teams/People/@Alex Kim.md | 2 | Meetings/Engineering/Weekly Team Leads... |
```

Ask the user: "all", "1,2", "none", or per-line skips.

### Step 3: Create stubs

For each confirmed stub, write `Teams/People/@<Name>.md` with this minimal frontmatter:

```yaml
---
FullName:
Team:
Location:
created: <ISO 8601 with offset>
---
```

Use `obsidian create path="Teams/People/@<Name>.md" content="<frontmatter>"` so Obsidian indexes it immediately (the next `/vault-health` run won't show the link as unresolved any more).

Leave `FullName`, `Team`, `Location` empty — the stub is a placeholder. The agent can fill in `FullName` if it can infer from the wikilink display text (e.g. `[[@Jane Doe]]` → `FullName: Jane Doe`).

### Step 4: Report

Print a summary:
```
Created 3 stubs:
  Teams/People/@Jane Doe.md
  Teams/People/@John Smith.md
  Teams/People/@Alex Kim.md

Next steps:
- Open each stub and fill in Team / Location / Start Date.
- Or run /onboard-person <name> to pull metadata from external sources.
```

### Step 5: Commit

See [/commit](../commit/SKILL.md). Commit message: `chore(people): add N stubs (Jane Doe, John Smith, ...)`.

## Important Notes

- **Don't create stubs for the user's own aliases** — they're handled by `USER.md` aliases.
- **Don't create stubs for candidate names** (someone interviewed once but never hired). The /vault-health report should let the user skip those manually. If a name has only 1-2 references and they're all from an interviews folder, surface a hint that this might be a candidate.
- **Filename collision**: if `Teams/People/@<Name>.md` exists already (even empty), don't overwrite. Skip and note in the report.
- Stubs make subsequent `/vault-health` runs cleaner — the unresolved-links count drops as stubs are created.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.