Sharing information securely and without dependencies is a common requirement in many professional settings. Omni Apps introduces a new AI agent skill called publish to address this directly. This skill is specifically designed to convert your internal brain pages into standalone HTML documents, which are then ready for secure distribution. It is particularly useful for developers, project managers, educators, or anyone needing to distribute documentation, reports, or educational materials that require both clarity and privacy, without relying on a live server or complex external setups. This skill ensures that once your content is processed, it is a self-contained unit, with all internal system metadata carefully stripped away and optionally protected with robust encryption. This simplifies the act of sharing, making it more efficient and secure.
Converting Brain
Pages to Shareable HTML
The core function of this skill is its ability to take your structured brain pages, which are typically markdown files, and transform them into self-contained HTML documents. This conversion is meticulous, focusing on producing a clean, reader-friendly output. A critical aspect of this process is its intelligent stripping of internal metadata. This includes all elements specific to your internal knowledge base system, such as frontmatter, internal citations, system-specific cross-links, and timelines. By removing these, the generated HTML is streamlined, ensuring it focuses solely on the primary content and presents a clean view to the recipient. Crucially, while internal references are removed to create a clean output, all external URLs embedded within your original document remain fully intact. This ensures that recipients can still access and follow links to external resources, websites, or documentation as intended. The end product is a standalone HTML file. This document requires no server, no internet connection (once downloaded), and no other external dependencies to be viewed. It can simply be opened directly in any standard web browser, making its distribution straightforward and universally accessible across various platforms. The primary command for this transformation is gbrain publish, which executes this conversion efficiently.
Secure
Distribution with Encryption and Flexible Deployment
Security is a primary consideration for this skill, which offers robust, optional encryption via AES-256-GCM password protection, explicitly designed for secure sharing. When you choose to encrypt your document, the entire process of securing the content is performed client-side. This means the encryption happens directly on your machine before the document is transmitted or stored, significantly enhancing the privacy and integrity of your data. This client-side encryption uses the browser's native Web Crypto API for all cryptographic operations, ensuring high standards of security. Key derivation, converting your password into a cryptographic key, is handled through PBKDF2, a well-established standard for robust password-based key generation. This skill is highly versatile in how it allows you to distribute these encrypted documents. You can generate files tailored for local file sharing, which is perfect for direct transfer via email attachments or USB drives to specific, trusted recipients. Alternatively, it supports direct cloud storage upload, allowing for smooth integration with popular cloud platforms and existing collaborative workflows. For broader, yet controlled, distribution, options for static hosting deployment are available, as well as dedicated GitHub integration for projects hosted on that platform. These diverse modes ensure flexibility in how you manage and disseminate your secure HTML documents. Complementing the core gbrain publish command, the gbrain files upload and gbrain files signed-url tools provide additional functionalities for efficiently managing and securely sharing these encrypted outputs, whether through direct uploads or temporary access links.
Practical
Usage and Important Limitations Interacting with this skill is designed to be intuitive and accessible through various triggers within the Omni Apps environment. You can initiate the document conversion and encryption process using simple commands such as 'share this page', 'publish page', or 'create shareable link'. These triggers streamline the user experience, allowing for quick deployment of your content. The necessary inputs are straightforward: you provide the path to your markdown file, an optional password if you choose to encrypt (though encryption is always applied by default), a custom title that will appear in the output HTML document, and your desired output destination (e.g., local, cloud, GitHub).
To provide a concrete example of the skill in action, consider a scenario where you need to share confidential project notes. Imagine you have a file named project_notes.md containing sensitive information that you want to share securely with a specific team. You would use the 'publish page' trigger, perhaps executing a command similar to gbrain publish project_notes.md --password "TeamAccessCode2024" --title "Q3 Project Review Summary" --output-dest local. This command instructs the skill to take project_notes.md, encrypt it with the specified password, set a custom title, and generate the resulting secure HTML file locally on your system. This encrypted HTML document is then ready for secure distribution to your team.
It is absolutely crucial to understand the design boundaries and limitations of this skill. Firstly, it is not intended for raw markdown distribution; its fundamental purpose is to convert markdown into HTML. Secondly, while the password parameter is "optional," the skill inherently produces encrypted output. Publishing without encryption is not a supported mode; the default is always encrypted. Thirdly, for security reasons, you must never send the encryption password through the same communication channel as the URL or file containing the published document. This is a fundamental security practice. Finally, the tool is designed to provide clean, isolated content, meaning it is not for sharing content that still contains internal system metadata; the process explicitly strips such elements.
Frequently Asked Questions
Q: Is encryption always mandatory when using the publish agent? A: Yes, publishing without encryption is not supported by the skill. All output documents are consistently encrypted with AES-256-GCM password protection, ensuring data security for shared content.
Q: Can I publish raw markdown files directly using this skill? A: No, the skill is not designed for raw markdown distribution. Its primary function is to convert your markdown brain pages into self-contained HTML documents, which are then encrypted.
Q: What happens to my internal links or citations when I use the skill? A: The skill systematically strips internal metadata. This includes elements such as frontmatter, internal citations, system-specific cross-links, and timelines, ensuring a clean, standalone document. However, external URLs are carefully preserved.
The publish skill provides a robust and straightforward method for creating and distributing secure, dependency-free HTML documents directly from your brain pages. It significantly streamlines the process of sharing confidential information, ensuring both content integrity and user privacy.
