connor/assistant-skills
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

brag-sheet: add insert/update script, simplify SKILL.md

Browse source
This commit is contained in:
Connor Rhodes 2026-05-22 16:23:31 -05:00
parent 37002b305e
commit eb8da9611e
2 changed files with 118 additions and 41 deletions
Download patch file Download diff file Expand all files Collapse all files

53
brag-sheet/SKILL.md
View file

@ -18,55 +18,26 @@ Each document has the following fields:
| `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. |
## Connection
## Script
Use the MongoDB connection from the `mongodb` skill. Connection string:
```
mongodb://root:3wwfoUjyk2E2zWELXFlLuHqfw1ALlOp4pb2H5Vq3TImbMIHL2h1u8Jej2mjzCPl@docdb.connorrhodes.com:35563
```
## How to Add an Entry
When the user provides positive feedback they want to save:
1. **Collect the information** from the user:
- `note`: The kudos/feedback text. This is usually provided verbatim (e.g., an email, Slack message, or verbal feedback someone gave them).
- `context`: Background from the user about the project, situation, or relationship context. Ask for this if not provided.
- `tags`: Default to `["work"]` unless the user specifies otherwise.
2. **Insert the document** using an inline Python script with `uv`:
```python
from pymongo import MongoClient
from datetime import datetime
client = MongoClient("mongodb://root:3wwfoUjyk2E2zWELXFlLuHqfw1ALlOp4pb2H5Vq3TImbMIHL2h1u8Jej2mjzCPl@docdb.connorrhodes.com:35563")
db = client["notes"]
collection = db["brag_sheet"]
result = collection.insert_one({
"date": datetime.now(),
"note": "<the kudos text>",
"context": "<the user's context about the project>",
"tags": ["work"]
})
print(f"Inserted: {result.inserted_id}")
client.close()
```
Run it via:
All inserts and updates go through `scripts/brag_sheet.py`. Run it with `uv`:
```bash
cat <<'PYEOF' | uv run --with pymongo python -
<script here>
PYEOF
# 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"]`.
- If the user doesn't specify tags, default to `work`.