diff --git a/doc.go b/doc.go
new file mode 100644
index 00000000..a3c3926b
--- /dev/null
+++ b/doc.go
@@ -0,0 +1,24 @@
+// Package skopeo provides libraries and commands to interact with containers images.
+//
+//    package main
+//
+//    import (
+//    	"fmt"
+//
+//    	"github.com/projectatomic/skopeo/docker"
+//    )
+//
+//    func main() {
+//    	img, err := docker.NewDockerImage("fedora", "", false)
+//    	if err != nil {
+//    		panic(err)
+//    	}
+//    	b, err := img.Manifest()
+//    	if err != nil {
+//    		panic(err)
+//    	}
+//    	fmt.Printf("%s", string(b))
+//    }
+//
+// TODO(runcom)
+package skopeo