entity-descriptions
Style conventions for writing entity DescriptionShort templates in mansion.rec. Use when adding or editing entities in data/worlds/mansion.rec to ensure consistent prose flow in /look output. Covers capitalization rules and punctuation for top-level entities vs container contents.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Entity Descriptions
Style guide for DescriptionShort templates in data/worlds/mansion.rec.
Style Rules
Top-level entities (no Container field):
- Full sentences: capital letter + period
- Example:
A {{ name }} sits in the middle of the room.
Container contents (has Container field):
- Capitalized fragments, no period (appear as bullet items)
- Example:
A teal {{ name }} with yellow roses in it
Examples
Top-level (full sentences)
Id: gallery_map
DescriptionShort: A rough {{ name }} hangs on the wall.
Id: lounge_chairs
DescriptionShort: Several {{ name }} are scattered around the room.
Id: library_couches
DescriptionShort: A pair of {{ name }} surround a coffee table in the center.
Container contents (capitalized fragments)
Id: foyer_flower_vase
Container: foyer_table
DescriptionShort: A teal {{ name }} with yellow roses in it
Id: foyer_plaque
Container: foyer_table
DescriptionShort: An {{ name }}
Containers with contents template
Id: foyer_table
DescriptionShort: A {{ name }} sits in the middle of the room{% if contents %}. On it:{{ contents }}{% endif %}
Rendered Output
Room descriptions render as:
You are standing in a grand entryway...
A *Wooden Table* sits in the middle of the room. On it:
- A teal *Flower Vase* with yellow roses in it
- An *Inscribed Plaque*
Validation
After editing, run:
just entities
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-28
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!