diff --git a/README.md b/README.md
index 79aa596..1e84adb 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,7 @@
-# Example package
+# `frontmatter-to-csv` - Convert YAML front matter to CSV
 
-This is a simple example package.
\ No newline at end of file
+This simple Python script will convert fields from the YAML front matter to your specified CSV fields.
+Optionally, it can transform some of the fields:
+
+* convert Python lists to comma-joined lists
+* convert varied human-readable durations to unified unit (hours)
\ No newline at end of file