diff --git a/dev_docs/operations/operations_landing.mdx b/dev_docs/operations/operations_landing.mdx
index cda44a96fe4d..8a54ee0a90a4 100644
--- a/dev_docs/operations/operations_landing.mdx
+++ b/dev_docs/operations/operations_landing.mdx
@@ -45,5 +45,6 @@ layout: landing
     { pageId: "kibDevDocsOpsExpect" },
     { pageId: "kibDevDocsOpsAmbientStorybookTypes" },
     { pageId: "kibDevDocsOpsAmbientUiTypes"},
+    { pageId: "kibDevDocsOpsTestSubjSelector"},
   ]}
 />
\ No newline at end of file
diff --git a/nav-kibana-dev.docnav.json b/nav-kibana-dev.docnav.json
index 4704430ba94b..4bd2349cb18d 100644
--- a/nav-kibana-dev.docnav.json
+++ b/nav-kibana-dev.docnav.json
@@ -200,7 +200,8 @@
             { "id": "kibDevDocsOpsJestSerializers" },
             { "id": "kibDevDocsOpsExpect" },
             { "id": "kibDevDocsOpsAmbientStorybookTypes" },
-            { "id": "kibDevDocsOpsAmbientUiTypes" }
+            { "id": "kibDevDocsOpsAmbientUiTypes" },
+            { "id": "kibDevDocsOpsTestSubjSelector"}
           ]
         }
       ]
diff --git a/packages/kbn-test-subj-selector/BUILD.bazel b/packages/kbn-test-subj-selector/BUILD.bazel
index f494b558ad5a..cc3334650a5d 100644
--- a/packages/kbn-test-subj-selector/BUILD.bazel
+++ b/packages/kbn-test-subj-selector/BUILD.bazel
@@ -18,7 +18,6 @@ filegroup(
 
 NPM_MODULE_EXTRA_FILES = [
   "package.json",
-  "README.md",
 ]
 
 RUNTIME_DEPS = []
diff --git a/packages/kbn-test-subj-selector/README.md b/packages/kbn-test-subj-selector/README.md
deleted file mode 100755
index 463d6c808e29..000000000000
--- a/packages/kbn-test-subj-selector/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# test-subj-selector
-
-Convert a string from test subject syntax to css selectors.
diff --git a/packages/kbn-test-subj-selector/README.mdx b/packages/kbn-test-subj-selector/README.mdx
new file mode 100755
index 000000000000..c924d1593712
--- /dev/null
+++ b/packages/kbn-test-subj-selector/README.mdx
@@ -0,0 +1,10 @@
+---
+id: kibDevDocsOpsTestSubjSelector
+slug: /kibana-dev-docs/ops/test-subj-selector
+title: "@kbn/test-subj-selector"
+description: An utility package to quickly get css selectors from strings
+date: 2022-05-19
+tags: ['kibana', 'dev', 'contributor', 'operations', 'test', 'subj', 'selector']
+---
+
+Converts a string from a test subject syntax into a css selectors composed by `data-test-subj`.