assistant-skills/brag-sheet/SKILL.md

43 lines
1.6 KiB
Markdown

# Skill: Brag Sheet
Add entries to the `notes.brag_sheet` MongoDB collection, which stores kudos, congratulations, and accomplishments for use in performance reviews, job applications, etc.
## Collection
- **Database**: `notes`
- **Collection**: `brag_sheet`
## Document Schema
Each document has the following fields:
| Field | Type | Description |
|-------|------|-------------|
| `date` | `datetime` | Native MongoDB datetime, set to current time at insertion |
| `note` | `string` | The kudos/positive feedback text (e.g., a coworker's words about you) |
| `context` | `string` | Your own notes explaining the project/situation context where this feedback came from |
| `tags` | `array[string]` | Tags for categorization. Default: `["work"]`. Can include additional tags like `"personal"`, etc. |
## Script
All inserts and updates go through `scripts/brag_sheet.py`. Run it with `uv`:
```bash
# Add a new entry
uv run ~/notes/skills/brag-sheet/scripts/brag_sheet.py add "<note>" "<context>" [--tags tag1,tag2]
# Update an existing entry by doc ID
uv run ~/notes/skills/brag-sheet/scripts/brag_sheet.py update <doc_id> [--note "..."] [--context "..."] [--tags tag1,tag2]
```
- `note`: The kudos/feedback text, verbatim.
- `context`: Background on the project or situation.
- `tags`: Comma-separated. Defaults to `work` if omitted.
## What to Ask the User
When the user says "add this to my brag sheet" or similar:
- The `note` text is usually provided directly by the user.
- If the user doesn't provide `context`, ask: "What's the context for this feedback?" or "What project or situation was this from?"
- If the user doesn't specify tags, default to `work`.