Context
A skill is how the learner stops rewriting the same prompt. The starter workspace already includes a first skill draft for listing improvement.
Do This Now
- Ask Codex to read the existing listing improver skill.
- Have it compare the skill against the one-listing report.
- Improve the skill so it captures what worked.
- Run the skill again on a second listing.
Where to paste this:
Paste this into Codex inside the starter workspace.
Paste this into Codex inside the starter workspace.
Prompt To Use
Use the starter skill at skills/real-estate-listing-improver/SKILL.md.
First inspect:
- skills/real-estate-listing-improver/SKILL.md
- reports/one-listing-improvement.md if it exists
- rubrics/listing-quality-rubric.md
- examples/good-listing.md
- examples/bad-listing.md
Then:
1. Explain what the skill currently teaches Codex to do.
2. Identify what is missing based on the one-listing report.
3. Propose a tighter SKILL.md revision.
4. Do not apply changes until I approve.
5. After approval, test the revised skill on a different listing and create reports/skill-test-listing.md.What You Should See
Expected result
Codex should treat the skill as reusable workflow instructions, not just a prompt. It should propose a revision and then test it only after approval.
If It Goes Wrong
- If it rewrites the skill too broadly, ask for the smallest useful change.
- If it puts lots of examples into SKILL.md, ask it to move examples into references or examples instead.
- If the second test is worse, ask it to compare against the first report and diagnose the regression.
Make It Yours
Create separate skills later for rentals, luxury homes, commercial listings, seller updates, buyer match notes, and neighborhood guides.
Practical Output
A reusable listing-improver skill and a second test report.
Your Working Notes
What I tried
What I need to change
Codex Task Card
| Files to inspect | skills/real-estate-listing-improver/SKILL.md, rubrics, examples, reports. |
|---|---|
| Expected files created | Updated skill after approval and reports/skill-test-listing.md. |
| Verification checklist | The second run should be easier, more structured, and closer to your quality bar. |
| Follow-up if weak | Turn the lessons from reports/skill-test-listing.md into one specific improvement to the skill and one regression example. |