@supersuit/superskill 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.2.1 (2026-09-28)
+
+- An unquoted value that is only a comment now reads as empty, which is what YAML means. Before
+  this, `source: # TODO` came back as the string "# TODO" and a list item written as `- # none
+  yet` came back as "# none yet", so a downstream linter counted a comment placeholder as a
+  filled-in field and passed specs it should have failed. A comment-only value followed by a
+  more-indented block still opens that nested map or list, exactly as it did with no comment.
+  Quoted values are untouched: `key: "# literal"` still reads as "# literal".
+
 ## 0.2.0 (2026-09-28)
 
 - The frontmatter reader reads nesting: maps inside maps, lists of maps, lists inside maps, and

package/SPEC.md

@@ -1,6 +1,6 @@
 # The superskill standard
 
-**Version 0.2.0** (2026-09-28). The reference checker is `@supersuit/superskill`; where this
+**Version 0.2.1** (2026-09-28). The reference checker is `@supersuit/superskill`; where this
 document and the checker disagree, the checker has a bug.
 
 A **superskill** runs on frontier intelligence, is checked against examples a person approved,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supersuit/superskill",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Score any agent skill folder as skill, tested, or superskill. An open standard and a zero-dependency CLI.",
   "type": "module",
   "bin": { "superskill": "bin/superskill.mjs" },

package/src/frontmatter.mjs

@@ -27,6 +27,10 @@ const indentOf = (l) => l.length - l.trimStart().length;
 // at any depth, read by indentation. Until then the reader stopped at one level and IGNORED
 // anything deeper, so a list of maps came back as nothing and no error said so. Values still
 // stay strings. A stray indented line at the top level is still tolerated, as before.
+// 0.2.1: an unquoted value or list item that is only a comment (`key: # TODO`, `- # none yet`)
+// reads as empty, the same as no value at all, which is what YAML means. A comment-only value
+// that is followed by a more-indented block still opens that nested map or list, exactly as
+// `key:` with nothing after it does.
 export function parseYamlSubset(lines) {
   return parseMap(lines, 0, 0, true)[0];
 }
@@ -62,7 +66,7 @@ function parseMap(lines, i, indent, top = false) {
       const [v, next] = readBlock(lines, i, ind, rest[0]);
       out[key] = v; i = next; continue;
     }
-    if (rest === "") {
+    if (rest === "" || rest.startsWith("#")) {
       const j = nextContent(lines, i);
       if (j < lines.length) {
         const ci = indentOf(lines[j]);
@@ -90,7 +94,7 @@ function parseList(lines, i, indent) {
     const content = t === "-" ? "" : t.slice(1).trimStart();
     const at = line.indexOf(content, ind + 1); // where the item's content starts on the line
     i++;
-    if (content === "") {
+    if (content === "" || content.startsWith("#")) {
       const j = nextContent(lines, i);
       if (j < lines.length && indentOf(lines[j]) > ind) {
         const ci = indentOf(lines[j]);