hive-mapping

Schema mappings for auto-syncing embedded documents

16 stars

Best use case

hive-mapping is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Schema mappings for auto-syncing embedded documents

Teams using hive-mapping should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/hive-mapping/SKILL.md --create-dirs "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/development/hive-mapping/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/hive-mapping/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How hive-mapping Compares

Feature / Agenthive-mappingStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Schema mappings for auto-syncing embedded documents

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Schema Mappings

Auto-sync embedded references when source documents change.

Location: `/src/autoMap/schemaMappings.json`

## How It Works

1. You embed document references in schemas (e.g., `user: { _id, fullName }`)
2. You register the mapping in `schemaMappings.json`
3. When source document updates, all referencing documents sync automatically

## Config Format

```json
{
  "tasks": {
    "user": {
      "schema": "users"
    },
    "project": {
      "schema": "projects"
    }
  }
}
```

Means: In `tasks` collection, fields `user` and `project` reference `users` and `projects` collections.

## Example

**Schema with embedded reference:**
```javascript
// tasks.schema.js
project: z
  .object({
    _id: z.string(),
    name: z.coerce.string().nullable().optional(),
    logoUrl: z.coerce.string().nullable().optional(),
  })
  .nullable()
  .optional(),
```

**Mapping config:**
```json
{
  "tasks": {
    "project": {
      "schema": "projects"
    }
  }
}
```

**Result:** When project's `name` or `logoUrl` changes, all tasks with that project update automatically.

## Adding New Mapping

1. Define embedded reference in schema (include fields to sync)
2. Add entry to `schemaMappings.json`:

```json
{
  "yourResource": {
    "fieldName": {
      "schema": "sourceSchema"
    }
  }
}
```

## Rules

- Only fields defined in the embedded object shape are synced
- Works for both single references and arrays
- Changes sync on source document `updated` event

Related Skills

hive-scheduler

16
from diegosouzapw/awesome-omni-skill

How to create scheduled jobs in Hive framework

hive-overview

16
from diegosouzapw/awesome-omni-skill

Hive framework structure and conventions. Apply when working with this codebase.

hive-handler

16
from diegosouzapw/awesome-omni-skill

How to create event handlers in Hive framework

hive-endpoint

16
from diegosouzapw/awesome-omni-skill

How to create API endpoints in Hive framework

hive-credentials

16
from diegosouzapw/awesome-omni-skill

Set up and install credentials for an agent. Detects missing credentials from agent config, collects them from the user, and stores them securely in the local encrypted store at ~/.hive/credentials.

file-archiver

16
from diegosouzapw/awesome-omni-skill

创建和解压ZIP、TAR和GZIP压缩包,支持密码保护。

ddd-context-mapping

16
from diegosouzapw/awesome-omni-skill

Map relationships between bounded contexts and define integration contracts using DDD context mapping patterns.

chatgpt-archive-topic-background-report

16
from diegosouzapw/awesome-omni-skill

Build a topic-focused research collection from ChatGPT archive viewer conversations (latest archive or all archives), run a background Responses API consolidation job with web search, and save markdown plus raw response artifacts. Use when the user asks to find archive threads by topic, reconcile repetition/contradictions, and generate a saved report with minimal polling noise.

action-mapping-designer

16
from diegosouzapw/awesome-omni-skill

This skill should be used when ensuring training focuses on performance outcomes and business impact. Use this skill to identify essential content, design performance-focused activities, create job aids, and eliminate unnecessary training.

hive-mind-advanced

16
from diegosouzapw/awesome-omni-skill

Advanced Hive Mind collective intelligence system for queen-led multi-agent coordination with consensus mechanisms and persistent memory

github-archive

16
from diegosouzapw/awesome-omni-skill

Investigate GitHub security incidents using tamper-proof GitHub Archive data via BigQuery. Use when verifying repository activity claims, recovering deleted PRs/branches/tags/repos, attributing actions to actors, or reconstructing attack timelines. Provides immutable forensic evidence of all public GitHub events since 2011.

archive

16
from diegosouzapw/awesome-omni-skill

Archive completed task/spec work to ./.gtd/archive/