diff --git a/README.md b/README.md
index d89008c..1ca805c 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,23 @@
-# skillagent
+# SkillAgent Module
+
+This module provides a general-purpose Agent framework that integrates with Skillkit.
+
+## Features
+
+- Dynamic Skill and Script loading from skillspath
+- Multi-layer document feeding to LLM (Skill / Script / Example)
+- Multi-skill, multi-script DAG planning
+- Parameter schema validation and multi-turn resume
+- Unified Skillkit invocation interface
+
+## Usage
+
+```python
+from skillagent.agent import SkillAgent
+from skillagent.skill_loader import SkillLoader
+from skillagent.skillkit_wrapper import SkillkitWrapper
+
+loader = SkillLoader("./skillagent/skillspath")
+skillkit = SkillkitWrapper(skillkit_client)
+agent = SkillAgent(loader, skillkit, llm)