# House Inventory

> Manage home inventory and storage tracking with intelligent image indexing.

- **Type:** Skill
- **Install:** `agentstack add skill-kongaharsha-hermes-stack-house-inventory`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kongaharsha](https://agentstack.voostack.com/s/kongaharsha)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [kongaharsha](https://github.com/kongaharsha)
- **Source:** https://github.com/kongaharsha/hermes_stack/tree/main/skills/house-inventory

## Install

```sh
agentstack add skill-kongaharsha-hermes-stack-house-inventory
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# House Inventory

## Overview
House Inventory is a disciplined system for cataloging physical assets, tracking container contents (boxes, bags, suitcases), and maintaining a verifiable index of reference imagery. Designed for precision, speed, and consistency.

## Prerequisites
- **GBrain Setup:** This skill requires an initialized `gbrain` environment. If you do not have one, set it up first: 
  `gbrain init` or see [GBrain Repository](https://github.com/kongaharsha/hermes_stack).
- **Inventory File:** A valid markdown inventory file at the configured `storage_path`.

## Workflow
1. **Cataloging:** Extract objects/item descriptions from image uploads or manual text input.
2. **Container Indexing:** Identify the source/target container (e.g., Box #1).
3. **Validation:** Review extracted lists with the user to ensure terminology compliance before write operations.
4. **Persisting:** Use structured `patch` operations to append or update entries while maintaining file integrity.

## Format Principles
*   **Container-First Hierarchy:** Every item must belong to a defined container.
    ```markdown
    ### Container: [Name]
    *   **Type:** [Box/Bag/Suitcase]
    *   **Location:** [Storage/Home]
    *   **Reference Photos:** [link1], [link2]
    *   **Items:** [Standardized bulleted list]
    ```

## Standardized Terminology
*   **Consistency:** Use precise naming conventions (e.g., "Diyas" over "Mats"). 
*   **Renaming:** If descriptive terms are identified as inaccurate post-cataloging, perform an immediate refactor of the inventory entry to ensure future search accuracy.

## Reliability Patterns
*   **Atomic Patching:** All modifications to the inventory file must be done via `patch` operations to prevent data loss.
*   **Read-Before-Write:** Must read current `house-inventory.md` state prior to execution to prevent conflicts with other agents.

## Anti-Patterns
*   **Hardcoded Pathing:** Never assume absolute local file paths outside of the `storage_path` configuration.
*   **Vision Guessing:** Never assume item identity from low-confidence image analysis. If ambiguous, trigger a manual verification request to the user.
*   **Cluttered Indexing:** Do not create duplicate container entries; always verify existence before cataloging new items.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kongaharsha](https://github.com/kongaharsha)
- **Source:** [kongaharsha/hermes_stack](https://github.com/kongaharsha/hermes_stack)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-kongaharsha-hermes-stack-house-inventory
- Seller: https://agentstack.voostack.com/s/kongaharsha
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
