Restore frontmatter metadata in README

README.md

@@ -11,3 +11,48 @@ license: mit
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+# 🧠 Clarity Agent
+
+**Clarity Agent** is a lightweight AI assistant that helps you understand and reflect on text.
+
+It takes a pasted input or uploaded `.txt`/`.md` file and returns:
+- 📚 A clean **summary**
+- 🤔 A list of **follow-up questions** to deepen understanding
+
+Built using:
+- 🧩 [Gradio](https://gradio.app) for the interactive interface
+- 🧠 `transformers` by Hugging Face for LLM-powered summarization
+- 🚀 Hosted as a Hugging Face Space
+
+---
+
+## 💡 Use Case
+
+This tool helps:
+- Students & researchers summarize documents
+- Knowledge workers explore dense material
+- Thinkers and readers reflect on what matters next
+
+---
+
+## 🛠️ How to Use
+
+1. Paste text into the box — or upload a `.txt` or `.md` file
+2. Click **Analyze**
+3. Read the summary and suggested next questions
+
+---
+
+## 🧪 Roadmap Ideas
+
+- Add URL input to summarize web pages
+- Extract keywords or topic tags
+- Export results to Markdown
+- Add memory or topic chaining (via MCP)
+
+---
+
+## 🤝 Hackathon Participation
+
+This project is part of the [Hugging Face Gradio Hackathon 2025](https://huggingface.co/spaces/ysharma/gradio-hackathon-registration-2025), Track 3: **Agentic Demo Showcase**.