# Omcustomupdate External

> Update agents from external sources (GitHub, docs, etc.) Use when this capability is needed.

- Skill: `tomevault-io/omcustomupdate-external` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/omcustomupdate-external`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/omcustomupdate-external/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/omcustomupdate-external

---


# Update External Sources Skill

Updates agents, skills, and guides that have external sources (GitHub, official docs, etc.) to their latest versions.

## Options

```
--check, -c      Check for updates without applying
--force, -f      Force update even if current
--verbose, -v    Show detailed changes
```

## External Sources

### Agents
```yaml
fe-vercel-agent:
  source: https://github.com/vercel-labs/agent-skills
  type: github
```

### Skills (from external agents)
```yaml
react-best-practices:
  source: https://github.com/vercel-labs/agent-skills
  type: github

web-design-guidelines:
  source: https://github.com/vercel-labs/agent-skills
  type: github
```

### Skills (from skills.sh marketplace)
```yaml
<skill-name>:
  source: <owner/repo>
  type: skills-sh
```

Skills installed via `skills-sh-search` are tracked with `source-type: skills-sh` in their frontmatter. Update checks use `npx skills check`.

### Guides (reference documentation)
```yaml
golang:
  source: https://go.dev/doc/effective_go
  type: documentation

python:
  source: https://peps.python.org/pep-0008/
  type: documentation
```

## Workflow

```
1. Identify external resources
   ├── Scan index.yaml files
   ├── Find source.type = "external"
   └── Collect URLs and versions

2. Check for updates
   ├── GitHub: Check releases/commits
   ├── skills-sh: Run "npx skills check"
   ├── Documentation: Check last-modified
   └── Compare with current version

3. Fetch updates
   ├── Download new content
   ├── Parse and extract relevant parts
   └── Validate content

4. Apply updates
   ├── Update content files
   ├── Update version in index.yaml
   ├── Update last_updated timestamp
   └── Run mgr-supplier:audit to validate
```

## Version Tracking

Updates are tracked in each resource's index.yaml:

```yaml
source:
  type: external
  origin: github
  url: https://github.com/vercel-labs/agent-skills
  version: "1.2.0"
  last_updated: "2026-01-22"
  update_history:
    - version: "1.0.0"
      date: "2026-01-20"
    - version: "1.2.0"
      date: "2026-01-22"

# skills.sh source
source:
  type: external
  origin: skills-sh
  registry: https://skills.sh
  installed_via: "npx skills add <owner/repo>"
  last_checked: "2026-02-20"
```

## Output Format

### Check Mode
```
[mgr-updater:external --check]

Checking for external updates...

Agents:
  fe-vercel-agent
    Current: v1.0.0
    Latest:  v1.2.0
    Status:  UPDATE AVAILABLE

Skills:
  react-best-practices
    Source: github.com/vercel-labs/agent-skills
    Status: UPDATE AVAILABLE (linked to agent)

Guides:
  golang
    Source: go.dev/doc/effective_go
    Last fetched: 2026-01-22
    Status: UP TO DATE

Summary:
  Updates available: 1 agent, 1 skill
  Up to date: 11 guides

Run "mgr-updater:external" to apply updates.
```

### Update Mode
```
[mgr-updater:external]

Updating external resources...

[1/2] Updating fe-vercel-agent
  Fetching from github.com/vercel-labs/agent-skills...
  ✓ Downloaded v1.2.0
  ✓ Updated AGENT.md
  ✓ Updated index.yaml (version: 1.0.0 → 1.2.0)
  ✓ Updated related skills

[2/2] Validating updates
  Running mgr-supplier:audit...
  ✓ All dependencies valid

Summary:
  Updated: 1 agent
  Synced: 3 skills
  Validated: ✓

All external resources updated successfully.
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/baekenough) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-12 -->