Merge pull request #208 from hypercerts-org/docs/skill-organization-sync

docs + fix: sync SKILL.md, normalize linearDocument ref, correct changeset

Author: s-adamantine

.agents/skills/building-with-hypercerts-lexicons/SKILL.md

@@ -238,15 +238,15 @@ if (result.success) {
 
 ### Certified — shared lexicons
 
-| Lexicon              | NSID                               | Purpose                                                                         |
-| -------------------- | ---------------------------------- | ------------------------------------------------------------------------------- |
-| **Location**         | `app.certified.location`           | Geographic reference via [Location Protocol](https://spec.decentralizedgeo.org) |
-| **Profile**          | `app.certified.actor.profile`      | User profile: display name, bio, avatar, banner                                 |
-| **Organization**     | `app.certified.actor.organization` | Organization metadata: legal structure, URLs, location                          |
-| **Badge Definition** | `app.certified.badge.definition`   | Defines a badge with type, title, icon, optional issuer allowlist               |
-| **Badge Award**      | `app.certified.badge.award`        | Awards a badge to a user, project, or activity                                  |
-| **Badge Response**   | `app.certified.badge.response`     | Recipient accepts or rejects a badge award                                      |
-| **EVM Link**         | `app.certified.link.evm`           | Verifiable ATProto DID to EVM wallet link via EIP-712 signature                 |
+| Lexicon              | NSID                               | Purpose                                                                                                                      |
+| -------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| **Location**         | `app.certified.location`           | Geographic reference via [Location Protocol](https://spec.decentralizedgeo.org)                                              |
+| **Profile**          | `app.certified.actor.profile`      | User profile: display name, bio, avatar, banner                                                                              |
+| **Organization**     | `app.certified.actor.organization` | Organization metadata: legal structure, URLs, location, founding date, optional long description, discoverability visibility |
+| **Badge Definition** | `app.certified.badge.definition`   | Defines a badge with type, title, icon, optional issuer allowlist                                                            |
+| **Badge Award**      | `app.certified.badge.award`        | Awards a badge to a user, project, or activity                                                                               |
+| **Badge Response**   | `app.certified.badge.response`     | Recipient accepts or rejects a badge award                                                                                   |
+| **EVM Link**         | `app.certified.link.evm`           | Verifiable ATProto DID to EVM wallet link via EIP-712 signature                                                              |
 
 ## Relationship Map
 

.changeset/add-organization-page-and-visibility.md

@@ -2,4 +2,4 @@
 "@hypercerts-org/lexicon": minor
 ---
 
-Add optional `longDescription` and `visibility` fields to `app.certified.actor.organization` lexicon. `longDescription` uses the description union pattern (inline text/markdown or strongRef to a rich-text document) for consistency with activity, collection, and attachment.
+Add optional `longDescription` and `visibility` fields to `app.certified.actor.organization` lexicon. `longDescription` uses the description union pattern — an inline string for plain text or markdown, an embedded Leaflet linear document for rich-text content, or a strong reference to an existing description record — matching the pattern used on activity, collection, and attachment.

.changeset/sync-skill-organization-fields.md

@@ -0,0 +1,5 @@
+---
+"@hypercerts-org/lexicon": patch
+---
+
+Sync `SKILL.md` Organization row with `README.md`: list `foundedDate`, `longDescription`, and `visibility` in the Certified lexicons overview table so AI agents building on top of `app.certified.actor.organization` see the full set of documented fields.

lexicons/app/certified/actor/organization.json

@@ -42,7 +42,7 @@
             "type": "union",
             "refs": [
               "org.hypercerts.defs#descriptionString",
-              "pub.leaflet.pages.linearDocument#main",
+              "pub.leaflet.pages.linearDocument",
               "com.atproto.repo.strongRef"
             ],
             "description": "Long-form description of the organization, such as its mission, history, or detailed project narrative. An inline string for plain text or markdown, a Leaflet linear document record embedded directly, or a strong reference to an existing document record."