From 69970f0aaf9105ab6a757b08be8f3e36dace26fb Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Thu, 11 Jun 2026 09:13:37 +1000
Subject: [PATCH 1/2] Update app building skill with publishing gotcha

---
 .../Skills/Resources/building-seq-plug-in-apps/SKILL.md   | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/SeqCli/Skills/Resources/building-seq-plug-in-apps/SKILL.md b/src/SeqCli/Skills/Resources/building-seq-plug-in-apps/SKILL.md
index 4aaadd78..b7c1ae32 100644
--- a/src/SeqCli/Skills/Resources/building-seq-plug-in-apps/SKILL.md
+++ b/src/SeqCli/Skills/Resources/building-seq-plug-in-apps/SKILL.md
@@ -46,6 +46,10 @@ Input apps use `Seq.Input.{Name}` naming.
     <PackageReference Include="Seq.Apps" Version="..." />
     <!-- Add Seq.Syntax (project or package reference) if using the Seq template language -->
   </ItemGroup>
+  <ItemGroup>
+    <!-- Package dependencies into primary NUPKG file, except those shipped in the app host itself -->
+    <None Include="./obj/publish/**/*" Exclude="./obj/publish/$(MSBuildProjectName).dll;./obj/publish/Seq.Apps.dll;./obj/publish/Serilog.dll" Pack="true" PackagePath="lib/$(TargetFramework)" />
+  </ItemGroup>
 </Project>
 ```
 
@@ -521,6 +525,10 @@ Take care that the smoke test project doesn't exit or assume completion before a
 - Default time zone: `Etc/UTC`
 - Default date/time format: `o` (ISO-8601 round-trip)
 
+## Gotchas
+
+- Seq does not resolve package dependencies when installing apps. Apps must package assembly dependencies into their own NUPKG (see CSPROJ conventions above). 
+
 ## References
 
 - [CLEF specification](https://clef-json.org) — the Compact Log Event Format (`@t`, `@mt`, `@m`, `@l`, `@x`, `@i`, `@r`)

From f427e9ce6fa86e85b943b22b1f59a7af56ec8354 Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Thu, 11 Jun 2026 09:17:19 +1000
Subject: [PATCH 2/2] Fix note pointing out @sa property name

---
 src/SeqCli/Skills/Resources/building-seq-plug-in-apps/SKILL.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SeqCli/Skills/Resources/building-seq-plug-in-apps/SKILL.md b/src/SeqCli/Skills/Resources/building-seq-plug-in-apps/SKILL.md
index b7c1ae32..f32e1a1e 100644
--- a/src/SeqCli/Skills/Resources/building-seq-plug-in-apps/SKILL.md
+++ b/src/SeqCli/Skills/Resources/building-seq-plug-in-apps/SKILL.md
@@ -532,7 +532,7 @@ Take care that the smoke test project doesn't exit or assume completion before a
 ## References
 
 - [CLEF specification](https://clef-json.org) — the Compact Log Event Format (`@t`, `@mt`, `@m`, `@l`, `@x`, `@i`, `@r`)
-- [Posting raw events](https://docs.datalust.co/docs/posting-raw-events) — CLEF reference including Seq trace extensions (`@tr`, `@sp`, `@ps`, `@st`, `@sc`, `@ra`, `@sk`)
+- [Posting raw events](https://docs.datalust.co/docs/posting-raw-events) — CLEF reference including Seq trace extensions (`@tr`, `@sp`, `@ps`, `@st`, `@sa`, `@ra`, `@sk`)
 - [Template syntax](https://docs.datalust.co/docs/template-syntax) — documentation for the Seq template language used in app settings
 - [seq-apps-runtime](https://github.com/datalust/seq-apps-runtime) — source code for the `Seq.Apps` API (`SeqApp`, `ISubscribeToAsync<LogEvent>`, `ISubscribeToJsonAsync`, etc.)
 - [seqcli](https://github.com/datalust/seqcli) — source code for the `seqcli app run` command that Seq uses to host apps at runtime